diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index b46ed2fc10aff..681ccda930fe3 100644 --- a/.openpublishing.redirection.json +++ b/.openpublishing.redirection.json @@ -405,6 +405,34 @@ "redirect_url": "/dotnet/articles/csharp/whats-new/index", "redirect_document_id": true }, + { + "source_path": "docs/framework/deployment/windows/index.md", + "redirect_url": "/dotnet/articles/framework/install/" + }, + { + "source_path": "docs/framework/deployment/windows/7.md", + "redirect_url": "/dotnet/articles/framework/install/on-windows-7" + }, + { + "source_path": "docs/framework/deployment/windows/8.md", + "redirect_url": "/dotnet/articles/framework/install/on-windows-8" + }, + { + "source_path": "docs/framework/deployment/windows/10.md", + "redirect_url": "/dotnet/articles/framework/install/on-windows-10" + }, + { + "source_path": "docs/framework/deployment/windows/vista.md", + "redirect_url": "/dotnet/articles/framework/install/on-windows-vista" + }, + { + "source_path": "docs/framework/deployment/windows/xp.md", + "redirect_url": "/dotnet/articles/framework/install/on-windows-xp" + }, + { + "source_path": "docs/framework/deployment/windows/installing-dotnet-35-windows-10.md", + "redirect_url": "/dotnet/articles/framework/install/dotnet-35-windows-10" + }, { "source_path": "docs/framework/docker/aspnetmvc.md", "redirect_url": "/aspnet/mvc/overview/deployment/docker-aspnetmvc", diff --git a/docs/framework/TOC.md b/docs/framework/TOC.md index 9765dc32a691b..3dca249e09664 100644 --- a/docs/framework/TOC.md +++ b/docs/framework/TOC.md @@ -15,4 +15,3 @@ ## [Developing for multiple platforms](../standard/cross-platform/index.md) ## [Deployment](deployment/index.md) ## [Performance](performance/index.md) - diff --git a/docs/framework/deployment/client-profile.md b/docs/framework/deployment/client-profile.md index 93bebe6fdf389..c633a82b2e23d 100644 --- a/docs/framework/deployment/client-profile.md +++ b/docs/framework/deployment/client-profile.md @@ -34,7 +34,7 @@ The .NET Client Profile is a subset of the .NET Framework, which was provided wi However, if you are targeting the .NET Framework 4 or 3.5 and want to learn more about the Client Profile and when to use it, see [.NET Framework Client Profile](http://msdn.microsoft.com/library/cc656912\(v=vs.100\).aspx) in the .NET Framework 4 documentation. - When you install the [!INCLUDE[net_v45](../../../includes/net-v45-md.md)], the .NET Framework 4 Client Profile is updated to the full version of the .NET Framework. For information about installing the [!INCLUDE[net_v45](../../../includes/net-v45-md.md)], see [Installation Guide](../../../docs/framework/install/guide-for-developers.md). + When you install the [!INCLUDE[net_v45](../../../includes/net-v45-md.md)], the .NET Framework 4 Client Profile is updated to the full version of the .NET Framework. For information about installing the [!INCLUDE[net_v45](../../../includes/net-v45-md.md)], see [Install the .NET Framework for developers](../../../docs/framework/install/guide-for-developers.md). ## See Also [.NET Framework Client Profile (.NET Framework 4)](http://msdn.microsoft.com/library/cc656912\(v=vs.100\).aspx) diff --git a/docs/framework/deployment/deployment-guide-for-developers.md b/docs/framework/deployment/deployment-guide-for-developers.md index 8c4aa25effea4..2d6ec11559edc 100644 --- a/docs/framework/deployment/deployment-guide-for-developers.md +++ b/docs/framework/deployment/deployment-guide-for-developers.md @@ -395,7 +395,7 @@ The following table lists .NET Framework language packs that are available for t ## See also [Deployment Guide for Administrators](../../../docs/framework/deployment/guide-for-administrators.md) [System Requirements](../../../docs/framework/get-started/system-requirements.md) - [Installation Guide](../../../docs/framework/install/guide-for-developers.md) - [Troubleshooting](../../../docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md) + [Install the .NET Framework for developers](../../../docs/framework/install/guide-for-developers.md) + [Troubleshoot blocked .NET Framework installations and uninstallations](../../../docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md) [Reducing System Restarts During .NET Framework 4.5 Installations](../../../docs/framework/deployment/reducing-system-restarts.md) [How to: Get Progress from the .NET Framework 4.5 Installer](../../../docs/framework/deployment/how-to-get-progress-from-the-dotnet-installer.md) \ No newline at end of file diff --git a/docs/framework/deployment/index.md b/docs/framework/deployment/index.md index 14c0cb054e530..5a4f633c97699 100644 --- a/docs/framework/deployment/index.md +++ b/docs/framework/deployment/index.md @@ -51,11 +51,11 @@ This article helps you get started deploying the .NET Framework with your applic - [Reducing system restarts during .NET Framework 4.5 installations](../../../docs/framework/deployment/reducing-system-restarts.md) - - [Troubleshooting Blocked .NET Framework Installations and Uninstallations](~/docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md) + - [Troubleshoot blocked .NET Framework installations and uninstallations](~/docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md) - Deploying the .NET Framework with a client application (for developers): - - [Using InstallShield](../../../docs/framework/deployment/deployment-guide-for-developers.md#installshield) in a setup and deployment project + - [Using InstallShield](../../../docs/framework/deployment/deployment-guide-for-developers.md#installshield-deployment) in a setup and deployment project - [Using a Visual Studio ClickOnce application](../../../docs/framework/deployment/deployment-guide-for-developers.md#clickonce-deployment) diff --git a/docs/framework/deployment/initialization-errors-managing-the-user-experience.md b/docs/framework/deployment/initialization-errors-managing-the-user-experience.md index 02e7e4bddd365..76b7ae4b31ff7 100644 --- a/docs/framework/deployment/initialization-errors-managing-the-user-experience.md +++ b/docs/framework/deployment/initialization-errors-managing-the-user-experience.md @@ -83,7 +83,7 @@ Typical error message for initialization errors |XBAP host|Launches WPF XBAP applications.|Is shown in case of a missing .NET Framework version, starting with the [!INCLUDE[net_v45](../../../includes/net-v45-md.md)]|No| ## [!INCLUDE[win8](../../../includes/win8-md.md)] Behavior and UI - The CLR activation system provides the same behavior and UI on [!INCLUDE[win8](../../../includes/win8-md.md)] as it does on other versions of the Windows operating system, except when it encounters issues loading CLR 2.0. [!INCLUDE[win8](../../../includes/win8-md.md)] includes the [!INCLUDE[net_v45](../../../includes/net-v45-md.md)], which uses CLR 4.5. However, [!INCLUDE[win8](../../../includes/win8-md.md)] does not include the .NET Framework 2.0, 3.0, or 3.5, which all use CLR 2.0. As a result, applications that depend on CLR 2.0 do not run on [!INCLUDE[win8](../../../includes/win8-md.md)] by default. Instead, they display the following dialog box to enable users to install the .NET Framework 3.5. Users can also enable the .NET Framework 3.5 in Control Panel. Both options are discussed in the article [Installing the .NET Framework 3.5 on Windows 8 and later versions](../../../docs/framework/install/net-framework-3-5-on-windows-8-plus.md). + The CLR activation system provides the same behavior and UI on [!INCLUDE[win8](../../../includes/win8-md.md)] as it does on other versions of the Windows operating system, except when it encounters issues loading CLR 2.0. [!INCLUDE[win8](../../../includes/win8-md.md)] includes the [!INCLUDE[net_v45](../../../includes/net-v45-md.md)], which uses CLR 4.5. However, [!INCLUDE[win8](../../../includes/win8-md.md)] does not include the .NET Framework 2.0, 3.0, or 3.5, which all use CLR 2.0. As a result, applications that depend on CLR 2.0 do not run on [!INCLUDE[win8](../../../includes/win8-md.md)] by default. Instead, they display the following dialog box to enable users to install the .NET Framework 3.5. Users can also enable the .NET Framework 3.5 in Control Panel. Both options are discussed in the article [Install the .NET Framework 3.5 on Windows 10, Windows 8.1, and Windows 8](../../../docs/framework/install/dotnet-35-windows-10.md). ![Dialog box for 3.5 install on Windows 8](../../../docs/framework/deployment/media/installdialog.png "installdialog") Prompt for installing the .NET Framework 3.5 on demand @@ -99,4 +99,4 @@ Prompt for installing the .NET Framework 3.5 on demand [Deployment Guide for Developers](../../../docs/framework/deployment/deployment-guide-for-developers.md) [How to: Configure an App to Support .NET Framework 4 or 4.5](../../../docs/framework/migration-guide/how-to-configure-an-app-to-support-net-framework-4-or-4-5.md) [How to: Debug CLR Activation Issues](../../../docs/framework/deployment/how-to-debug-clr-activation-issues.md) - [Installing the .NET Framework 3.5 on Windows 8 and later versions](../../../docs/framework/install/net-framework-3-5-on-windows-8-plus.md) \ No newline at end of file + [Install the .NET Framework 3.5 on Windows 10, Windows 8.1, and Windows 8](../../../docs/framework/install/dotnet-35-windows-10.md) \ No newline at end of file diff --git a/docs/framework/deployment/windows/10.md b/docs/framework/deployment/windows/10.md deleted file mode 100644 index 8d9cc6c96120c..0000000000000 --- a/docs/framework/deployment/windows/10.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Installing the .NET Framework on Windows 10 -description: Learn how to install .NET Framework on Windows 10 -author: rlander -keywords: .NET Framework, Install - -ms.date: 03/28/2017 -ms.topic: article -ms.prod: .net-framework-4.6 -ms.technology: vs-ide-deployment -ms.devlang: dotnet -ms.assetid: 85cda1d5-c6g4-4eb5-93e6-4f478de07ff7 ---- - -# Installing the .NET Framework on Windows 10 - -You may need the .NET Framework to run an application on Windows 10. You can use the following instructions to help you. The instructions depend on which version of the .NET Framework you need. - -## .NET Framework 4.6.2 - -The .NET Framework 4.6.2 is included with Windows 10 Anniversary Update. - -If you are on an earlier version of Windows 10, you will need to upgrade to [Windows 10 Anniversary Update](https://www.microsoft.com/software-download/windows10) to get the .NET Framework 4.6.2. - -The .NET Framework 4.6.2 can be used to run applications built for .NET Framework 4.0 or later. - -## .NET Framework 3.5 - -Follow the instructions to install the [.NET Framework 3.5 on Windows 10](installing-dotnet-35-windows-10.md). - -The .NET Framework 3.5 can be used to run applications built for .NET Framework 1.0 through 3.5. - -## Help - -You can [contact Microsoft for help](mailto:dotnet-install-help@microsoft.com?subject=Help installing .NET Framework) if you cannot get the correct version of the .NET Framework installed. diff --git a/docs/framework/deployment/windows/7.md b/docs/framework/deployment/windows/7.md deleted file mode 100644 index 4cc777143c57e..0000000000000 --- a/docs/framework/deployment/windows/7.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Installing the .NET Framework on Windows 7 SP1 -description: Learn how to install .NET Framework on Windows 7 SP1 -author: rlander -keywords: .NET Framework, Install - -ms.date: 03/28/2017 -ms.topic: article -ms.prod: .net-framework-4.6 -ms.technology: vs-ide-deployment -ms.devlang: dotnet -ms.assetid: 85cda1d5-c9a4-4eb5-93e6-4f878de07fd7 ---- - -# Installing the .NET Framework on Windows 7 SP1 - -You may need the .NET Framework to run an application on Windows 7 SP1. You can install the latest supported versions using the following instructions. The instructions depend on which version of the .NET Framework you need. - -## .NET Framework 4.6.2 - -You can install the [.NET Framework 4.6.2](https://go.microsoft.com/fwlink/?linkid=845529&source=dotnetdocs) or later on Windows 7. - -The .NET Framework 4.6.2 is included with [Windows 10 Anniversary Update](https://www.microsoft.com/software-download/windows10). - -The .NET Framework 4.6.2 can be used to run applications built for .NET Framework 4.0 or later. - -## .NET Framework 3.5 - -The .NET Framework 3.5 is included with Windows 7. - -The .NET Framework 3.5 can be used to run applications built for .NET Framework 1.0 through 3.5. - -## Help - -You can [contact Microsoft for help](mailto:dotnet-install-help@microsoft.com?subject=Help installing .NET Framework) if you cannot get the correct version of the .NET Framework installed. diff --git a/docs/framework/deployment/windows/8.md b/docs/framework/deployment/windows/8.md deleted file mode 100644 index 378195fc6606e..0000000000000 --- a/docs/framework/deployment/windows/8.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Installing the .NET Framework on Windows 8 -description: Learn how to install .NET Framework on Windows 8 -author: rlander -keywords: .NET Framework, Install - -ms.date: 03/28/2017 -ms.topic: article -ms.prod: .net-framework-4.6 -ms.technology: vs-ide-deployment -ms.devlang: dotnet -ms.assetid: 85cda1d5-c9a4-4eb5-93e6-4f478de07ff7 ---- - -# Installing the .NET Framework on Windows 8 - -You may need the .NET Framework to run an application on Windows 8. You can use the following instructions to help you. The instructions depend on which version of the .NET Framework you need. - -## .NET Framework 4.6.2 - -You can install the [.NET Framework 4.6.2](https://go.microsoft.com/fwlink/?linkid=845529&source=dotnetdocs) or later on Windows 8. - -The .NET Framework 4.6.2 is included with [Windows 10 Anniversary Update](https://www.microsoft.com/software-download/windows10). - -The .NET Framework 4.6.2 can be used to run applications built for .NET Framework 4.0 or later. - -## .NET Framework 3.5 - -Follow the instructions to install the [.NET Framework 3.5 on Windows 10](installing-dotnet-35-windows-10.md). - -The .NET Framework 3.5 can be used to run applications built for .NET Framework 1.0 through 3.5. - -## Help - -You can [contact Microsoft for help](mailto:dotnet-install-help@microsoft.com?subject=Help installing .NET Framework) if you cannot get the correct version of the .NET Framework installed. diff --git a/docs/framework/deployment/windows/index.md b/docs/framework/deployment/windows/index.md deleted file mode 100644 index 981715e459a9d..0000000000000 --- a/docs/framework/deployment/windows/index.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: Install the .NET Framework on Windows -description: Learn how to install the .NET Framework on Windows -author: rlander -keywords: .NET Framework, Install - -ms.date: 03/28/2017 -ms.topic: article -ms.prod: .net-framework-4.6 -ms.technology: vs-ide-deployment -ms.devlang: dotnet -ms.assetid: 87cda1d5-c5g8-8eb9-93e8-5f478de07ff7 ---- - -# Installing the .NET Framework on Windows - -The following documents describe how to install the .NET Framework for each Windows version. - -## Version Differences - -The .NET Framework is included with Windows. Each Windows version includes a single .NET Framework version, which may not be the one you need. If you would like to use a different version of the .NET Framework for a given version of Windows, then you must install it. - -In general, a higher .NET Framework version will run an application that was built for a lower .NET Framework version. For example, the .NET Framework 4.6.2 will run an application built for .NET Framework 4.0. There is one exception to this rule. Applications built for .NET Framework 1.0 through 3.5 can be run on .NET Framework 3.5 but not on .NET Framework 4.0 or later. - -## Supported Windows versions - -- [Windows 10 or Windows Server 2016](10.md) -- [Windows 8 or Windows Server 2012](8.md) -- [Windows 7 or Windows Server 2008](7.md) -- [Windows Vista or Windows Server 2003](vista.md) - -## Unsupported Windows versions - -- [Windows XP](xp.md) \ No newline at end of file diff --git a/docs/framework/deployment/windows/installing-dotnet-35-windows-10.md b/docs/framework/deployment/windows/installing-dotnet-35-windows-10.md deleted file mode 100644 index b6aee23f11657..0000000000000 --- a/docs/framework/deployment/windows/installing-dotnet-35-windows-10.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: Install the .NET Framework 3.5 on Windows 10, Windows 8.1 and Windows 8 -description: Learn how to install .NET Framework 3.5 on Windows 10, Windows 8.1 and Windows 8 -author: rlander -keywords: .NET Framework, Install - -ms.date: 03/28/2017 -ms.topic: article -ms.prod: .net-framework-4.6 -ms.technology: vs-ide-deployment -ms.devlang: dotnet -ms.assetid: 67cda1d5-c6g4-4eb5-93e6-4f478de07ff7 ---- - -# Install the .NET Framework 3.5 on Windows 10, Windows 8.1 and Windows 8 - -You may need the .NET Framework 3.5 to run an application on Windows 10, Windows 8.1 and Windows 8. You can use the following instructions to help you. You can also use these instructions for earlier Windows versions. - -## Install the .NET Framework 3.5 on Demand - -You may see the following configuration dialog if you try to run an application that requires the .NET Framework 3.5. Choose **Install this feature** to enable the .NET Framework 3.5. This option requires an Internet connection. - -![.NET Framework Installation Dialog](./media/dotnet-framework-installation-dialog.jpg) - -## Enable the .NET Framework 3.5 in Control Panel - -You can enable the .NET Framework 3.5 through the Windows Control Panel. This option requires an Internet connection. - -1. Press the Windows key Windows ![Windows logo](https://i-msdn.sec.s-msft.com/dynimg/IC721376.jpeg) on your keyboard, type Windows Features, and press Enter. This brings up the **Turn Windows features on or off** dialog box. -2. Select the **.NET Framework 3.5 (includes .NET 2.0 and 3.0)** check box, press OK, and reboot your computer if prompted. - -![Installing .NET with the control panel](./media/dotnet-control-panel.png) - -You do not need to select the child items for Windows Communication Foundation (WCF) HTTP activation unless you are a developer or server administrator who requires this functionality. diff --git a/docs/framework/deployment/windows/media/dotnet-control-panel.png b/docs/framework/deployment/windows/media/dotnet-control-panel.png deleted file mode 100644 index cdeb8c86303ee..0000000000000 Binary files a/docs/framework/deployment/windows/media/dotnet-control-panel.png and /dev/null differ diff --git a/docs/framework/deployment/windows/media/dotnet-framework-installation-dialog.jpg b/docs/framework/deployment/windows/media/dotnet-framework-installation-dialog.jpg deleted file mode 100644 index 905564ab40ab4..0000000000000 Binary files a/docs/framework/deployment/windows/media/dotnet-framework-installation-dialog.jpg and /dev/null differ diff --git a/docs/framework/deployment/windows/vista.md b/docs/framework/deployment/windows/vista.md deleted file mode 100644 index b0d1e9e02114e..0000000000000 --- a/docs/framework/deployment/windows/vista.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Install the .NET Framework on Windows Vista -description: Learn how to install .NET Framework on Windows Vista -author: rlander -keywords: .NET Framework, Install - -ms.date: 03/28/2017 -ms.topic: article -ms.prod: .net-framework-4.6 -ms.technology: vs-ide-deployment -ms.devlang: dotnet -ms.assetid: 67cda1d5-c6g5-5eb5-93e6-5f478de07ff7 ---- - -# Installing the .NET Framework on Windows Vista - -You may need the .NET Framework to run an application on Windows Vista. You can use the following instructions to help you. The instructions depend on which version of the .NET Framework you need. - -## .NET Framework 4.6.1 and later - -You cannot install the .NET Framework 4.6.1 or later on Windows Vista. Instead, you must upgrade to a later Windows version to use .NET Framework 4.6.1 or later. - -The .NET Framework 4.6.2 is included with [Windows 10 Anniversary Update](https://www.microsoft.com/software-download/windows10). - -## .NET Framework 4.6 - -You can install the [.NET Framework 4.6](http://go.microsoft.com/fwlink/?LinkID=213834&dotnetdocs) on Windows Vista. - -## .NET Framework 3.5 - -You can install the [.NET Framework 3.5](http://go.microsoft.com/fwlink/?LinkID=213834&dotnetdocs) on Windows Vista. - -The .NET Framework 3.5 can be used to run applications built for .NET Framework 1.0 through 3.5. - -## Help - -You can [contact Microsoft for help](mailto:dotnet-install-help@microsoft.com?subject=Help installing .NET Framework) if you cannot get the correct version of the .NET Framework installed. diff --git a/docs/framework/deployment/windows/xp.md b/docs/framework/deployment/windows/xp.md deleted file mode 100644 index 23bcf042e0305..0000000000000 --- a/docs/framework/deployment/windows/xp.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Install the .NET Framework on Windows XP -description: Learn how to install .NET Framework on Windows XP -author: rlander -keywords: .NET Framework, Install - -ms.date: 03/28/2017 -ms.topic: article -ms.prod: .net-framework-4.6 -ms.technology: vs-ide-deployment -ms.devlang: dotnet -ms.assetid: 87cda1d5-c8g5-5eb5-93e8-5f478de07ff7 ---- - -# Installing the .NET Framework on Windows XP - -> [!NOTE] -> Windows XP is no longer supported by Microsoft. We recommend you upgrade to Windows 10, which is supported and supports the latest version of the .NET Framework. This document is provided solely as a helpful troubleshooting guide. - -You may need the .NET Framework to run an application on Windows XP. You can use the following instructions to help you. The instructions depend on which version of the .NET Framework you need. - -## .NET Framework 4.5 and later - -You cannot install the .NET Framework 4.5 or later on Windows XP. Instead, you must upgrade to a later Windows version to use a later version of the .NET Framework. - -The .NET Framework 4.6.2 is included with [Windows 10 Anniversary Update](https://www.microsoft.com/software-download/windows10). - -## .NET Framework 4.0.3 - -You can install the [.NET Framework 4.0.3](http://go.microsoft.com/fwlink/?LinkID=213834) on Windows XP. The .NET Framework 4.0.3 requires that the [.NET Framework 4](http://go.microsoft.com/fwlink/?LinkID=213834) is installed first. Both of these .NET Framework versions are no longer supported by Microsoft. - -## .NET Framework 4 - -You can install the [.NET Framework 4](http://go.microsoft.com/fwlink/?LinkID=213834&dotnetdocs) on Windows XP. It's no longer supported by Microsoft. - -## .NET Framework 3.5 - -You can install the [.NET Framework 3.5](http://go.microsoft.com/fwlink/?LinkID=213834&dotnetdocs) on Windows XP. - -The .NET Framework 3.5 can be used to run applications built for .NET Framework 1.0 through 3.5. - -## Help - -You can [contact Microsoft for help](mailto:dotnet-install-help@microsoft.com?subject=Help installing .NET Framework) if you cannot get the correct version of the .NET Framework installed. diff --git a/docs/framework/get-started/index.md b/docs/framework/get-started/index.md index 51d9b077ab360..712b04541a8f2 100644 --- a/docs/framework/get-started/index.md +++ b/docs/framework/get-started/index.md @@ -76,11 +76,11 @@ The .NET Framework is a runtime execution environment that manages applications |Title|Description| |-----------|-----------------| |[Overview](../../../docs/framework/get-started/overview.md)|Provides detailed information for developers who build applications that target the .NET Framework.| +|[Installation guide](../../../docs/framework/install/index.md)|Provides information about installing the .NET Framework.| |[The .NET Framework and Out-of-Band Releases](../../../docs/framework/get-started/the-net-framework-and-out-of-band-releases.md)|Describes the .NET Framework out-of-band releases and how to use them in your app.| |[System Requirements](../../../docs/framework/get-started/system-requirements.md)|Lists the hardware and software requirements for running the .NET Framework.| |[.NET Core and Open-Source](../../../docs/framework/get-started/net-core-and-open-source.md)|Describes what .NET Core is in relation to the .NET Framework and how to access the open-source .NET Core projects.| |[.NET Core documentation](https://docs.microsoft.com/dotnet/)|The conceptual and API reference documentation for .NET Core.| -|[Installation Guide](../../../docs/framework/install/guide-for-developers.md)|Provides information about installing the .NET Framework.| ## See Also [.NET Framework Guide](../../../docs/framework/index.md) diff --git a/docs/framework/get-started/overview.md b/docs/framework/get-started/overview.md index be5340aa58e88..044d085fdec3e 100644 --- a/docs/framework/get-started/overview.md +++ b/docs/framework/get-started/overview.md @@ -36,7 +36,7 @@ The .NET Framework is a technology that supports building and running the next g - To build all communication on industry standards to ensure that code based on the .NET Framework can integrate with any other code. > [!NOTE] -> For a general introduction to the .NET Framework for both users and developers, see [Getting Started](../../../docs/framework/get-started/index.md). To download the .NET Framework, see [Installation Guide](../../../docs/framework/install/guide-for-developers.md). +> For a general introduction to the .NET Framework for both users and developers, see [Getting Started](../../../docs/framework/get-started/index.md). The .NET Framework consists of the common language runtime and the .NET Framework class library. The common language runtime is the foundation of the .NET Framework. You can think of the runtime as an agent that manages code at execution time, providing core services such as memory management, thread management, and remoting, while also enforcing strict type safety and other forms of code accuracy that promote security and robustness. In fact, the concept of code management is a fundamental principle of the runtime. Code that targets the runtime is known as managed code, while code that does not target the runtime is known as unmanaged code. The class library is a comprehensive, object-oriented collection of reusable types that you can use to develop applications ranging from traditional command-line or graphical user interface (GUI) applications to applications based on the latest innovations provided by ASP.NET, such as Web Forms and XML Web services. @@ -97,7 +97,7 @@ The .NET Framework is a technology that supports building and running the next g ## See Also [System Requirements](../../../docs/framework/get-started/system-requirements.md) - [Installation Guide](../../../docs/framework/install/guide-for-developers.md) + [Installation guide](../../../docs/framework/install/index.md) [Development Guide](../../../docs/framework/development-guide.md) [Tools](../../../docs/framework/tools/index.md) [.NET Framework Samples](http://msdn.microsoft.com/en-us/177055f8-4a1f-43e7-aee6-995c196079b1) diff --git a/docs/framework/get-started/system-requirements.md b/docs/framework/get-started/system-requirements.md index 2f2c78299884d..67de72b640077 100644 --- a/docs/framework/get-started/system-requirements.md +++ b/docs/framework/get-started/system-requirements.md @@ -24,7 +24,7 @@ manager: "wpickett" # .NET Framework system requirements The tables in this topic provide the hardware, operating system, and software requirements for the .NET Framework 4.5 and its point releases (4.5.1 and 4.5.2), the [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] and its point releases (4.6.1 and 4.6.2), and the .NET Framework 4.7. Development environments that enable you to develop applications for the .NET Framework have a separate set of requirements. - For download information and links, see [Installation Guide](../../../docs/framework/install/guide-for-developers.md). + For download information and links, see [Install the .NET Framework for developers](../../../docs/framework/install/guide-for-developers.md). For information on the support lifecycle of .NET Framework versions, see [Microsoft Support Lifecycle](https://support.microsoft.com/en-us/lifecycle/search?sort=PN&alpha=Microsoft%20.NET%20Framework&Filter=FilterNO). @@ -91,6 +91,6 @@ The tables in this topic provide the hardware, operating system, and software re - On 64-bit operating systems, the .NET Framework supports both WOW64 (32-bit processing on a 64-bit machine) and native 64-bit processing. ## See Also - [Installation Guide](../../../docs/framework/install/guide-for-developers.md) + [Installation Guide](../../../docs/framework/install/index.md) [Getting Started](../../../docs/framework/get-started/index.md) - [Troubleshooting](../../../docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md) \ No newline at end of file + [Troubleshoot blocked .NET Framework installations and uninstallations](../../../docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md) \ No newline at end of file diff --git a/docs/framework/index.md b/docs/framework/index.md index 3dac85aad0b49..a03edeee7bc52 100644 --- a/docs/framework/index.md +++ b/docs/framework/index.md @@ -24,9 +24,9 @@ manager: "wpickett" # .NET Framework Guide > [!NOTE] -> This .NET Framework content set includes information for .NET Framework versions 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, and 4.7. To download the .NET Framework, see [Installing the .NET Framework](../../docs/framework/install/guide-for-developers.md). For a list of new features and changes in the NET Framework 4.5, the [!INCLUDE[net_v46](../../includes/net-v46-md.md)], their point releases, and the .NET Framework 4.7, see [What's New in the .NET Framework](../../docs/framework/whats-new/index.md). For a list of supported platforms, see [.NET Framework System Requirements](../../docs/framework/get-started/system-requirements.md). +> This .NET Framework content set includes information for .NET Framework versions 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, and 4.7. To download the .NET Framework, see [Installing the .NET Framework](../../docs/framework/install/guide-for-developers.md). For a list of new features and changes in the NET Framework 4.5, the [!INCLUDE[net_v46](../../includes/net-v46-md.md)], their point releases, and the .NET Framework 4.7, see [What's New in the .NET Framework](../../docs/framework/whats-new/index.md). For a list of supported platforms, see [.NET Framework System Requirements](../../docs/framework/get-started/system-requirements.md). - The .NET Framework is a development platform for building apps for web, Windows, Windows Phone, Windows Server, and Microsoft Azure. It consists of the common language runtime (CLR) and the .NET Framework class library, which includes a broad range of functionality and support for many industry standards. +The .NET Framework is a development platform for building apps for web, Windows, Windows Phone, Windows Server, and Microsoft Azure. It consists of the common language runtime (CLR) and the .NET Framework class library, which includes a broad range of functionality and support for many industry standards. The .NET Framework provides many services, including memory management, type and memory safety, security, networking, and application deployment. It provides easy-to-use data structures and APIs that abstract the lower-level Windows operating system. You can use a variety of programming languages with the .NET Framework, including C#, F#, and Visual Basic. @@ -40,9 +40,10 @@ The .NET Framework comes with Windows, enabling you to run .NET Framework applic See [Repair the .NET Framework](./install/repair.md) to learn how to repair your .NET Framework installation if you are experiencing errors when installing the .NET Framework. -For more detailed information on downloading the .NET Framework, see [Installing the .NET Framework](../../docs/framework/install/guide-for-developers.md). +For more detailed information on downloading the .NET Framework, see [Install the .NET Framework for developers](../../docs/framework/install/guide-for-developers.md). -## In This Section +## In This Section + [What's New](../../docs/framework/whats-new/index.md) Describes key new features and changes in the latest versions of the .NET Framework. Includes lists of obsolete types and members, and provides a guide for migrating your applications from the previous version of the .NET Framework. diff --git a/docs/framework/install/dotnet-35-windows-10.md b/docs/framework/install/dotnet-35-windows-10.md index b6aee23f11657..f6ee7edadcf1a 100644 --- a/docs/framework/install/dotnet-35-windows-10.md +++ b/docs/framework/install/dotnet-35-windows-10.md @@ -1,10 +1,10 @@ --- -title: Install the .NET Framework 3.5 on Windows 10, Windows 8.1 and Windows 8 +title: Install the .NET Framework 3.5 on Windows 10, Windows 8.1, and Windows 8 description: Learn how to install .NET Framework 3.5 on Windows 10, Windows 8.1 and Windows 8 author: rlander keywords: .NET Framework, Install -ms.date: 03/28/2017 +ms.date: 04/20/2017 ms.topic: article ms.prod: .net-framework-4.6 ms.technology: vs-ide-deployment @@ -12,9 +12,9 @@ ms.devlang: dotnet ms.assetid: 67cda1d5-c6g4-4eb5-93e6-4f478de07ff7 --- -# Install the .NET Framework 3.5 on Windows 10, Windows 8.1 and Windows 8 +# Install the .NET Framework 3.5 on Windows 10, Windows 8.1, and Windows 8 -You may need the .NET Framework 3.5 to run an application on Windows 10, Windows 8.1 and Windows 8. You can use the following instructions to help you. You can also use these instructions for earlier Windows versions. +You may need the .NET Framework 3.5 to run an application on Windows 10, Windows 8.1, and Windows 8. You can also use these instructions for earlier Windows versions. ## Install the .NET Framework 3.5 on Demand @@ -26,9 +26,10 @@ You may see the following configuration dialog if you try to run an application You can enable the .NET Framework 3.5 through the Windows Control Panel. This option requires an Internet connection. -1. Press the Windows key Windows ![Windows logo](https://i-msdn.sec.s-msft.com/dynimg/IC721376.jpeg) on your keyboard, type Windows Features, and press Enter. This brings up the **Turn Windows features on or off** dialog box. -2. Select the **.NET Framework 3.5 (includes .NET 2.0 and 3.0)** check box, press OK, and reboot your computer if prompted. +1. Press the Windows key Windows ![Windows logo](https://i-msdn.sec.s-msft.com/dynimg/IC721376.jpeg) on your keyboard, type "Windows Features", and press Enter. The **Turn Windows features on or off** dialog box appears. -![Installing .NET with the control panel](./media/dotnet-control-panel.png) +2. Select the **.NET Framework 3.5 (includes .NET 2.0 and 3.0)** check box, select OK, and reboot your computer if prompted. -You do not need to select the child items for Windows Communication Foundation (WCF) HTTP activation unless you are a developer or server administrator who requires this functionality. + ![Installing .NET with the control panel](./media/dotnet-control-panel.png) + + You don't need to select the child items for **Windows Communication Foundation (WCF) HTTP Activation** and **Windows Communication Foundation (WCF) Non-HTTP Activation** unless you're a developer or server administrator who requires this functionality. diff --git a/docs/framework/install/guide-for-developers.md b/docs/framework/install/guide-for-developers.md index 92b98f0779db2..fb7abc4b7e68d 100644 --- a/docs/framework/install/guide-for-developers.md +++ b/docs/framework/install/guide-for-developers.md @@ -1,5 +1,5 @@ --- -title: "Installing the .NET Framework | Microsoft Docs" +title: "Install the .NET Framework for developers | Microsoft Docs" ms.custom: "" ms.date: "04/28/2017" ms.prod: ".net-framework" @@ -20,7 +20,8 @@ author: "rpetrusha" ms.author: "ronpet" manager: "wpickett" --- -# Installing the .NET Framework + +# Install the .NET Framework for developers .NET is an integral part of many applications running on Windows and provides common functionality for those applications to run. For developers, the .NET Framework provides a comprehensive and consistent programming model for building applications that have visually stunning user experiences and seamless and secure communication. @@ -31,10 +32,10 @@ Note that installing a new version of the .NET Framework doesn't always replace The fact that later .NET Framework 4.x versions are in-place updates to earlier versions means that you *cannot* install an earlier version listed in the table if a later version is already installed. For example, you cannot install the .NET Framework 4.6 on a Windows 10 November Update system, since the .NET Framework 4.6.1 is preinstalled on it. > [!NOTE] -> For information on the .NET Framework 3.5, see [Installing the .NET Framework 3.5 on Windows 8 and later versions](~/docs/framework/install/net-framework-3-5-on-windows-8-plus.md). - +> For information on the .NET Framework 3.5, see [Install the .NET Framework 3.5 on Windows 10, Windows 8.1, and Windows 8](~/docs/framework/install/dotnet-35-windows-10.md). + Use the following table for quick links, or read further for details. To view the system requirements for the .NET Framework before installation, see [System Requirements](~/docs/framework/get-started/system-requirements.md). For help with troubleshooting, see [Troubleshooting](~/docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md). - + |.NET Framework version|Developer installation|Redistributable installation|Platform support| |----------------------------|----------------------------|----------------------------------|----------------------| |**4.7**|[NET Framework 4.7 Dev Pack](http://go.microsoft.com/fwlink/?LinkId=825319)|[Download page for 4.7 web installer](http://go.microsoft.com/fwlink/?LinkId=825299)

[Download page for 4.7 offline installer](http://go.microsoft.com/fwlink/?LinkId=825303)|Included in:
Windows 10 Creators Update

You can install on:
Windows 10 Anniversary Update
Windows 8.1 and earlier
Windows Server 2012 R2 and earlier
(for a full list, see [system requirements](~/docs/framework/get-started/system-requirements.md))|| @@ -46,169 +47,175 @@ Use the following table for quick links, or read further for details. To view th |**4.5**|Included in Visual Studio 2012

Also available as part of the [Windows 8 SDK](http://msdn.microsoft.com/windows/hardware/hh852363)|[Download page for 4.5 web installer](http://go.microsoft.com/fwlink/p/?LinkId=245484)|Included in:
[!INCLUDE[win8](../../../includes/win8-md.md)]
[!INCLUDE[winserver8](../../../includes/winserver8-md.md)]
Visual Studio 2012

You can also install on:
Windows 7 and earlier
Windows Server 2008 SP2 and earlier
(for a full list, see [system requirements](~/docs/framework/get-started/system-requirements.md))| You can install the **Dev Pack** for a specific version of the .NET Framework, if one is available, on all supported platforms. - + You can install the **Web or Offline installer** on: - -- Windows 8.1 and earlier - -- Windows Server 2012 R2 and earlier - + +- Windows 8.1 and earlier + +- Windows Server 2012 R2 and earlier + For a full list, see [System Requirements](~/docs/framework/get-started/system-requirements.md). For a general introduction to the .NET Framework for both users and developers, see [Getting Started](../get-started/index.md). For information about deploying the .NET Framework with your app, see the [deployment guide](~/docs/framework/deployment/deployment-guide-for-developers.md). To read about the architecture and key features of the .NET Framework, see the [overview](~/docs/framework/get-started/overview.md). - + ## Installation choices -Install a developer targeting pack to develop against the most recent version of the .NET Framework in Visual Studio or another development environment, or download the .NET Framework redistributable for distribution with your app or control. +Install a developer targeting pack to develop against the most recent version of the .NET Framework in Visual Studio or another development environment, or download the .NET Framework redistributable for distribution with your app or control. + ## To install the .NET Framework developer or targeting pack -The developer pack for the .NET Framework 4.5.1 or 4.5.2, the targeting pack for the [!INCLUDE[net_v46](../../../includes/net-v46-md.md)], and the developer pack for the [!INCLUDE[net_v461](../../../includes/net-v461-md.md)], 4.6.2, or 4.7 provides the .NET Framework 4.5.1 or 4.5.2 or the [!INCLUDE[net_v46](../../../includes/net-v46-md.md)], 4.6.1 or 4.6.2, or the .NET Framework 4.7 reference assemblies, language packs, and IntelliSense files for use in an integrated development environment such as Visual Studio. If you are using Visual Studio, the developer pack or targeting pack also adds the installed version of the .NET Framework to the target choices when you create a new project. Choose one of these developer packs or the targeting pack: -- [Microsoft .NET Framework 4.7 Dev Pack](http://go.microsoft.com/fwlink/?LinkId=825319) - -- [Microsoft .NET Framework 4.6.2 Dev Pack](http://go.microsoft.com/fwlink/?LinkId=780617) -- [Microsoft .NET Framework 4.6.1 Dev Pack](http://go.microsoft.com/fwlink/?LinkId=690706) +The developer pack for the .NET Framework 4.5.1 or 4.5.2, the targeting pack for the [!INCLUDE[net_v46](../../../includes/net-v46-md.md)], and the developer pack for the [!INCLUDE[net_v461](../../../includes/net-v461-md.md)], 4.6.2, or 4.7 provides the .NET Framework 4.5.1 or 4.5.2 or the [!INCLUDE[net_v46](../../../includes/net-v46-md.md)], 4.6.1 or 4.6.2, or the .NET Framework 4.7 reference assemblies, language packs, and IntelliSense files for use in an integrated development environment such as Visual Studio. If you are using Visual Studio, the developer pack or targeting pack also adds the installed version of the .NET Framework to the target choices when you create a new project. Choose one of these developer packs or the targeting pack: -- [Microsoft .NET Framework 4.6 Targeting Pack](http://go.microsoft.com/fwlink/?LinkId=528261) - -- [.NET Framework 4.5.2 Developer Pack](http://go.microsoft.com/fwlink/?LinkId=397702) to install version 4.5.2 on Windows 8.1 or earlier, Visual Studio 2013, Visual Studio 2012, or other IDEs. - -- [.NET Framework 4.5.1 Developer Pack](http://go.microsoft.com/fwlink/?LinkId=324213) to install version 4.5.1 on Visual Studio 2012 or other IDEs. +- [Microsoft .NET Framework 4.7 Dev Pack](http://go.microsoft.com/fwlink/?LinkId=825319) +- [Microsoft .NET Framework 4.6.2 Dev Pack](http://go.microsoft.com/fwlink/?LinkId=780617) + +- [Microsoft .NET Framework 4.6.2 Dev Pack](http://go.microsoft.com/fwlink/?LinkId=780617) + +- [Microsoft .NET Framework 4.6.1 Dev Pack](http://go.microsoft.com/fwlink/?LinkId=690706) + +- [Microsoft .NET Framework 4.6 Targeting Pack](http://go.microsoft.com/fwlink/?LinkId=528261) + +- [.NET Framework 4.5.2 Developer Pack](http://go.microsoft.com/fwlink/?LinkId=397702) to install version 4.5.2 on Windows 8.1 or earlier, Visual Studio 2013, Visual Studio 2012, or other IDEs. + +- [.NET Framework 4.5.1 Developer Pack](http://go.microsoft.com/fwlink/?LinkId=324213) to install version 4.5.1 on Visual Studio 2012 or other IDEs. + From the developer pack download page, choose **Download**. Next choose **Run** or **Save**, and follow the instructions when prompted. - + ## To install or download the .NET Framework redistributable -These installers download the .NET Framework components for an app or control that targets those versions of the .NET Framework. These components must be installed on each computer where the app or control runs. Both installers are redistributable, so you can include them in the setup program for your app. +These installers download the .NET Framework components for an app or control that targets those versions of the .NET Framework. These components must be installed on each computer where the app or control runs. Both installers are redistributable, so you can include them in the setup program for your app. + The download page is provided in several languages, but most of the downloads are provided in English only. For additional language support, you must install a language pack. - + Two types of redistributable installations are available: - -- **Web installer** (web bootstrapper) downloads the required components and the language pack that matches the operating system of the installation computer from the web. This package is much smaller than the offline installer but requires a consistent Internet connection. You can download the [stand-alone language packs](#to-install-language-packs) to install additional language support. - -- **Offline installer** (stand-alone redistributable) contains all the required components for installing the .NET Framework but doesn't contain language packs. This download is larger than the web installer. The offline installer doesn't require an Internet connection. After you run the offline installer, you can download the [stand-alone language packs](#to-install-language-packs) to install language support. Use the offline installer if you can't rely on having a consistent Internet connection. - + +- **Web installer** (web bootstrapper) downloads the required components and the language pack that matches the operating system of the installation computer from the web. This package is much smaller than the offline installer but requires a consistent Internet connection. You can download the [stand-alone language packs](#standalone_language_packs) to install additional language support. + +- **Offline installer** (stand-alone redistributable) contains all the required components for installing the .NET Framework but doesn't contain language packs. This download is larger than the web installer. The offline installer doesn't require an Internet connection. After you run the offline installer, you can download the [stand-alone language packs](#standalone_language_packs) to install language support. Use the offline installer if you can't rely on having a consistent Internet connection. + Both web and offline installers are designed for x86-based and x64-based computers (see [system requirements](~/docs/framework/get-started/system-requirements.md)), but do not support Itanium-based computers. - -To install or download the .NET Framework from the Microsoft Download Center, follow these instructions. You can also use the links in the table to download the .exe files directly. - -1. Open the download page for the .NET Framework version you want to install: + +1. Open the download page for the .NET Framework version you want to install: - .NET Framework 4.7 ([web installer](http://go.microsoft.com/fwlink/?LinkId=825299) or [offline installer](http://go.microsoft.com/fwlink/p/?LinkId=825303)) - - .NET Framework 4.6.2 ([web installer](http://go.microsoft.com/fwlink/?LinkId=780597) or [offline installer](http://go.microsoft.com/fwlink/p/?LinkId=780601)) - - - .NET Framework 4.6.1 ([web installer](http://go.microsoft.com/fwlink/?LinkId=671729) or [offline installer](http://go.microsoft.com/fwlink/p/?LinkId=671744)) - - - .NET Framework 4.6 ([web installer](http://go.microsoft.com/fwlink/?LinkId=528259) or [offline installer](http://go.microsoft.com/fwlink/p/?LinkId=528233)) - - - .NET Framework 4.5.2 ([web installer](http://go.microsoft.com/fwlink/p/?LinkId=397703) or [offline installer](http://go.microsoft.com/fwlink/p/?LinkId=397706)) - - - .NET Framework 4.5.1 ([web installer](http://go.microsoft.com/fwlink/p/?LinkId=310158) or [offline installer](http://go.microsoft.com/fwlink/p/?LinkId=310159)) - - - [.NET Framework 4.5](http://go.microsoft.com/fwlink/p/?LinkId=245484) - -2. Select the language for the download page. This option does not download the localized resources of the .NET Framework; it only affects the text displayed on the download page. - -3. Choose **Download**. - -4. If prompted, select the download that matches your system architecture, and then choose **Next**. - -5. When the download prompt appears: - - - If you want to install the .NET Framework on your computer, choose **Run**, and then follow the prompts on your screen. - —or— - - - If you want to download the .NET Framework for redistribution, choose **Save**, and then follow the prompts on your screen. - -6. If you want to download resources for additional languages, follow the instructions in the next section to install one or more language packs. - + - .NET Framework 4.6.2 ([web installer](http://go.microsoft.com/fwlink/?LinkId=780597) or [offline installer](http://go.microsoft.com/fwlink/p/?LinkId=780601)) + + - .NET Framework 4.6.1 ([web installer](http://go.microsoft.com/fwlink/?LinkId=671729) or [offline installer](http://go.microsoft.com/fwlink/p/?LinkId=671744)) + + - .NET Framework 4.6 ([web installer](http://go.microsoft.com/fwlink/?LinkId=528259) or [offline installer](http://go.microsoft.com/fwlink/p/?LinkId=528233)) + + - .NET Framework 4.5.2 ([web installer](http://go.microsoft.com/fwlink/p/?LinkId=397703) or [offline installer](http://go.microsoft.com/fwlink/p/?LinkId=397706)) + + - .NET Framework 4.5.1 ([web installer](http://go.microsoft.com/fwlink/p/?LinkId=310158) or [offline installer](http://go.microsoft.com/fwlink/p/?LinkId=310159)) + + - [.NET Framework 4.5](http://go.microsoft.com/fwlink/p/?LinkId=245484) + +1. Select the language for the download page. This option does not download the localized resources of the .NET Framework; it only affects the text displayed on the download page. + +1. Choose **Download**. + +1. If prompted, select the download that matches your system architecture, and then choose **Next**. + +1. When the download prompt appears do **ONE** of the following: + + - If you want to install the .NET Framework on your computer, choose **Run**, and then follow the prompts on your screen. + + - If you want to download the .NET Framework for redistribution, choose **Save**, and then follow the prompts on your screen. + +1. If you want to download resources for additional languages, follow the instructions in the next section to install one or more language packs. + > [!NOTE] -> If you encounter any problems during the installation, see [Troubleshooting](~/docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md). - - **Installation notes:** - -- The [!INCLUDE[net_v451](../../../includes/net-v451-md.md)] and 4.5.2, as well as the [!INCLUDE[net_v46](../../../includes/net-v46-md.md)], 4.6.1, 4.6.2, and 4.7 are in-place updates to the [!INCLUDE[net_v45](../../../includes/net-v45-md.md)]. - +> If you encounter any problems during the installation, see [Troubleshooting](~/docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md). + + **Installation notes:** + +- The [!INCLUDE[net_v451](../../../includes/net-v451-md.md)] and 4.5.2, as well as the [!INCLUDE[net_v46](../../../includes/net-v46-md.md)], 4.6.1, 4.6.2, and 4.7 are in-place updates to the [!INCLUDE[net_v45](../../../includes/net-v45-md.md)]. + - The [!INCLUDE[net_v45](../../../includes/net-v45-md.md)], its point releases, the [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] and its point releases, and the .NET Framework 4.7 replace the [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)]. When you install these versions on a system that has the [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] installed, the assemblies are replaced. - -- Uninstalling the [!INCLUDE[net_v45](../../../includes/net-v45-md.md)], its point releases, the [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] and its point releases, or the .NET Framework 4.7 also removes pre-existing [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] files. If you want to go back to the [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)], you must reinstall it and any updates to it. (See [Installing the .NET Framework 4](http://go.microsoft.com/fwlink/p/?LinkId=230665).) - + +- Uninstalling the [!INCLUDE[net_v45](../../../includes/net-v45-md.md)], its point releases, the [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] and its point releases, or the .NET Framework 4.7 also removes pre-existing [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] files. If you want to go back to the [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)], you must reinstall it and any updates to it. (See [Installing the .NET Framework 4](http://go.microsoft.com/fwlink/p/?LinkId=230665).) + - You must have administrative credentials to install the [!INCLUDE[net_v45](../../../includes/net-v45-md.md)], its point releases, the .NET Framework 4.6 and its point releases, and the .NET Framework 4.7. - + - The .NET Framework 4.5 redistributable was updated on October 9, 2012 to correct an issue related to an improper timestamp on a digital certificate, which caused the digital signature on files produced and signed by Microsoft to expire prematurely. If you previously installed the .NET Framework 4.5 redistributable package dated August 16, 2012, we recommend that you update your copy with the latest redistributable from the [Microsoft Download Center](http://go.microsoft.com/fwlink/p/?LinkId=245484). For more information about this issue, see [Microsoft Security Advisory 2749655](http://technet.microsoft.com/security/advisory/2749655) and [Knowledge Base article 2770445](http://support.microsoft.com/kb/2770445). - + + ## To install language packs -Language packs are executable files that contain the localized resources (such as translated error messages and UI text) for supported languages. If you don't install a language pack, .NET Framework error messages and other text are displayed in English. Note that the web installer automatically installs the language pack that matches your operating system, but you can download additional language packs to your computer. The offline installers don’t include any language packs. In addition, language packs are not available for the .NET Framework 4.7. + Language packs are executable files that contain the localized resources (such as translated error messages and UI text) for supported languages. If you don't install a language pack, .NET Framework error messages and other text are displayed in English. Note that the web installer automatically installs the language pack that matches your operating system, but you can download additional language packs to your computer. The offline installers don’t include any language packs. In addition, language packs are not available for the .NET Framework 4.7. + > [!IMPORTANT] > The language packs don't contain the .NET Framework components that are required to run an app, so you must run the web or offline installer before you install a language pack. If you have already installed a language pack, uninstall it, install the .NET Framework, and then reinstall the language pack. - -1. Open the language pack download page for the .NET Framework version you've installed: - - - [.NET Framework 4.7 language packs](http://go.microsoft.com/fwlink/?LinkID=825306) - - - [.NET Framework 4.6.2 language packs](http://go.microsoft.com/fwlink/?LinkID=780604) - - - [.NET Framework 4.6.1 language packs](http://go.microsoft.com/fwlink/?LinkID=671747) - - - [.NET Framework 4.6 language packs](http://go.microsoft.com/fwlink/?LinkID=528314) - - - [.NET Framework 4.5.2 language packs](http://go.microsoft.com/fwlink/?LinkId=397701) - - - [.NET Framework 4.5.1 language packs](http://go.microsoft.com/fwlink/?LinkId=322101) - - - [.NET Framework 4.5 language packs](http://go.microsoft.com/fwlink/p/?LinkId=245451) - -2. In the language list, choose the language you want to download, and wait a few seconds for the page to reload in that language. - -3. Choose **Download**. - -The following table lists the supported languages: - -|Language|Culture| -|--------------|-------------| -|Arabic|ar| -|Czech|cs| -|Danish|da| -|Dutch|nl| -|Finnish|fi| -|French|fr| -|German|de| -|Greek|el| -|Hebrew|he| -|Hungarian|hu| -|Italian|it| -|Japanese|ja| -|Korean|ko| -|Norwegian|no| -|Polish|pl| -|Portuguese (Brazil)|pt-BR| -|Portuguese (Portugal)|pt-PT| -|Russian|ru| -|Simplified Chinese|zh-CHS| -|Spanish|es| -|Swedish|sv| -|Traditional Chinese|zh-CHT| -|Turkish|tr| -|US English|en-US| - -## Next steps - -- If you're new to the .NET Framework, see the [overview](~/docs/framework/get-started/overview.md) for an introduction to key concepts and components. - -- For new features and improvements in the .NET Framework 4.7, [!INCLUDE[net_v462](../../../includes/net-v462-md.md)], [!INCLUDE[net_v461](../../../includes/net-v461-md.md)], [!INCLUDE[net_v46](../../../includes/net-v46-md.md)], 4.5.2, 4.5.1, and 4.5, see [What's New](../../../docs/framework/whats-new/index.md). - + +1. Open the language pack download page for the .NET Framework version you've installed: + + - [.NET Framework 4.7 language packs](http://go.microsoft.com/fwlink/?LinkID=825306) + + - [.NET Framework 4.6.2 language packs](http://go.microsoft.com/fwlink/?LinkID=780604) + + - [.NET Framework 4.6.1 language packs](http://go.microsoft.com/fwlink/?LinkID=671747) + + - [.NET Framework 4.6 language packs](http://go.microsoft.com/fwlink/?LinkID=528314) + + - [.NET Framework 4.5.2 language packs](http://go.microsoft.com/fwlink/?LinkId=397701) + + - [.NET Framework 4.5.1 language packs](http://go.microsoft.com/fwlink/?LinkId=322101) + + - [.NET Framework 4.5 language packs](http://go.microsoft.com/fwlink/p/?LinkId=245451) + +2. In the language list, choose the language you want to download, and wait a few seconds for the page to reload in that language. + +3. Choose **Download**. + +The following table lists the supported languages. + +| Language | Culture | +| --------------------- | :-----: | +| Arabic | ar | +| Czech | cs | +| Danish | da | +| Dutch | nl | +| Finnish | fi | +| French | fr | +| German | de | +| Greek | el | +| Hebrew | he | +| Hungarian | hu | +| Italian | it | +| Japanese | ja | +| Korean | ko | +| Norwegian | no | +| Polish | pl | +| Portuguese (Brazil) | pt-BR | +| Portuguese (Portugal) | pt-PT | +| Russian | ru | +| Simplified Chinese | zh-CHS | +| Spanish | es | +| Swedish | sv | +| Traditional Chinese | zh-CHT | +| Turkish | tr | +| US English | en-US | + +## Next steps + +- If you're new to the .NET Framework, see the [overview](~/docs/framework/get-started/overview.md) for an introduction to key concepts and components. + +- For new features and improvements in the .NET Framework 4.7, [!INCLUDE[net_v462](../../../includes/net-v462-md.md)], [!INCLUDE[net_v461](../../../includes/net-v461-md.md)], [!INCLUDE[net_v46](../../../includes/net-v46-md.md)], 4.5.2, 4.5.1, and 4.5, see [What's New](../../../docs/framework/whats-new/index.md). + - For detailed information about deploying the .NET Framework with your app, see [Deployment Guide for Developers](~/docs/framework/deployment/deployment-guide-for-developers.md). + +- For changes that affect the deployment of the .NET Framework with your app, see [Reducing System Restarts During .NET Framework 4.5 Installations](~/docs/framework/deployment/reducing-system-restarts.md). + +- For information about migrating your app from the .NET Framework 4 to the [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] or one of its point releases, see the [migration guide](~/docs/framework/migration-guide/index.md). -- For changes that affect the deployment of the .NET Framework with your app, see [Reducing System Restarts During .NET Framework 4.5 Installations](~/docs/framework/deployment/reducing-system-restarts.md). - -- For information about migrating your app from the .NET Framework 4 to the [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] or one of its point releases, see the [migration guide](~/docs/framework/migration-guide/index.md). - -- See the [.NET Framework Reference Source](http://referencesource.microsoft.com/) to browse through the .NET Framework source code online. The reference source is also available on [Github](https://github.com/Microsoft/referencesource). You can [download the reference source](http://referencesource.microsoft.com/download.html) for offline viewing and step through the sources (including patches and updates) during debugging. For more information, see the blog entry [A new look for .NET Reference Source](http://blogs.msdn.com/b/dotnet/archive/2014/02/24/a-new-look-for-net-reference-source.aspx). - +- See the [.NET Framework Reference Source](http://referencesource.microsoft.com/) to browse through the .NET Framework source code online. The reference source is also available on [Github](https://github.com/Microsoft/referencesource). You can [download the reference source](http://referencesource.microsoft.com/download.html) for offline viewing and step through the sources (including patches and updates) during debugging. For more information, see the blog entry [A new look for .NET Reference Source](http://blogs.msdn.com/b/dotnet/archive/2014/02/24/a-new-look-for-net-reference-source.aspx). + ## See also - [Deployment Guide for Developers](~/docs/framework/deployment/deployment-guide-for-developers.md) - [Deployment Guide for Administrators](~/docs/framework/deployment/guide-for-administrators.md) - [Installing the .NET Framework 3.5 on Windows 8 and later versions](~/docs/framework/install/net-framework-3-5-on-windows-8-plus.md) - [Troubleshooting](~/docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md) \ No newline at end of file + +[Deployment Guide for Developers](~/docs/framework/deployment/deployment-guide-for-developers.md) +[Deployment Guide for Administrators](~/docs/framework/deployment/guide-for-administrators.md) +[Install the .NET Framework 3.5 on Windows 10, Windows 8.1, and Windows 8](~/docs/framework/install/dotnet-35-windows-10.md) +[Troubleshoot Blocked .NET Framework Installations and Uninstallations](~/docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md) diff --git a/docs/framework/install/index.md b/docs/framework/install/index.md index f249a5dadb3db..64df378bb9cd7 100644 --- a/docs/framework/install/index.md +++ b/docs/framework/install/index.md @@ -1,10 +1,9 @@ --- -title: Install the .NET Framework on Windows -description: Learn how to install the .NET Framework on Windows +title: Installation guide +description: Learn how to install the .NET Framework on Windows. author: rlander keywords: .NET Framework, Install - -ms.date: 03/28/2017 +ms.date: 04/27/2017 ms.topic: article ms.prod: .net-framework-4.6 ms.technology: vs-ide-deployment @@ -12,15 +11,7 @@ ms.devlang: dotnet ms.assetid: 87cda1d5-c5g8-8eb9-93e8-5f478de07ff7 --- -# Installing the .NET Framework on Windows - -The following documents describe how to install the .NET Framework for each Windows version. - -## Version Differences - -The .NET Framework is included with Windows. Each Windows version includes a single .NET Framework version, which may not be the one you need. If you would like to use a different version of the .NET Framework for a given version of Windows, then you must install it. - -In general, a higher .NET Framework version will run an application that was built for a lower .NET Framework version. For example, the .NET Framework 4.6.2 will run an application built for .NET Framework 4.0. There is one exception to this rule. Applications built for .NET Framework 1.0 through 3.5 can be run on .NET Framework 3.5 but not on .NET Framework 4.0 or later. +# Installation guide ## Supported Windows versions @@ -31,4 +22,8 @@ In general, a higher .NET Framework version will run an application that was bui ## Unsupported Windows versions -- [Windows XP](on-windows-xp.md) \ No newline at end of file +- [Windows XP](on-windows-xp.md) + +## See also + +[.NET Framework Development Guide](../development-guide.md) diff --git a/docs/framework/install/net-framework-3-5-on-windows-8-plus.md b/docs/framework/install/net-framework-3-5-on-windows-8-plus.md index cde86c551fa56..5ad892fe3e10c 100644 --- a/docs/framework/install/net-framework-3-5-on-windows-8-plus.md +++ b/docs/framework/install/net-framework-3-5-on-windows-8-plus.md @@ -1,7 +1,7 @@ --- -title: "Installing the .NET Framework 3.5 on Windows 8, Windows 8.1 and Windows 10 | Microsoft Docs" +title: "Troubleshooting the installation of the .NET Framework 3.5 on Windows 8, Windows 8.1, and Windows 10 | Microsoft Docs" ms.custom: "" -ms.date: "03/30/2017" +ms.date: "04/20/2017" ms.prod: ".net-framework" ms.reviewer: "" ms.suite: "" @@ -18,6 +18,7 @@ author: "mairaw" ms.author: "mairaw" manager: "wpickett" --- + # Installing the .NET Framework 3.5 on Windows 8, Windows 8.1 and Windows 10 The .NET Framework is an integral part of many applications running on Windows and provides common functionality for those applications to run. For developers, the .NET Framework provides a consistent programming model for building applications. if you are using the Windows operating system, the .NET Framework may already be installed on your computer. Specifically, the [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] is included with [!INCLUDE[win8](../../../includes/win8-md.md)], the [!INCLUDE[net_v451](../../../includes/net-v451-md.md)] is included with [!INCLUDE[win81](../../../includes/win81-md.md)] and the [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] is included with Windows 10. @@ -66,4 +67,4 @@ The .NET Framework is an integral part of many applications running on Windows a ![Installing the .NET Framework on Windows 8 or 8.1](../../../docs/framework/get-started/media/clr-net35-win8.png "CLR_NET35_Win8") ## See Also - [Installation Guide](../../../docs/framework/get-started/index.md) \ No newline at end of file + [Installation Guide](../../../docs/framework/get-started/index.md) diff --git a/docs/framework/install/on-windows-10.md b/docs/framework/install/on-windows-10.md index 6467cac5ecae0..ab3f7c44ad747 100644 --- a/docs/framework/install/on-windows-10.md +++ b/docs/framework/install/on-windows-10.md @@ -1,5 +1,5 @@ --- -title: Installing the .NET Framework on Windows 10 +title: Install the .NET Framework on Windows 10 description: Learn how to install .NET Framework on Windows 10 author: rlander keywords: .NET Framework, Install @@ -12,7 +12,7 @@ ms.devlang: dotnet ms.assetid: 85cda1d5-c6g4-4eb5-93e6-4f478de07ff7 --- -# Installing the .NET Framework on Windows 10 +# Install the .NET Framework on Windows 10 You may need the .NET Framework to run an application on Windows 10. You can use the following instructions to help you. The instructions depend on which version of the .NET Framework you need. @@ -20,13 +20,13 @@ You may need the .NET Framework to run an application on Windows 10. You can use The .NET Framework 4.6.2 is included with Windows 10 Anniversary Update. -If you are on an earlier version of Windows 10, you will need to upgrade to [Windows 10 Anniversary Update](https://www.microsoft.com/software-download/windows10) to get the .NET Framework 4.6.2. +If you are on an earlier version of Windows 10, you will need to upgrade to [Windows 10 Anniversary Update](https://www.microsoft.com/software-download/windows10) to get the .NET Framework 4.6.2. The .NET Framework 4.6.2 can be used to run applications built for .NET Framework 4.0 or later. ## .NET Framework 3.5 -Follow the instructions to install the [.NET Framework 3.5 on Windows 10](dotnet-35-windows-10.md). +Follow the instructions to install the [.NET Framework 3.5 on Windows 10](dotnet-35-windows-10.md). The .NET Framework 3.5 can be used to run applications built for .NET Framework 1.0 through 3.5. diff --git a/docs/framework/install/on-windows-7.md b/docs/framework/install/on-windows-7.md index 85fdb9cd4d018..7a8293347accb 100644 --- a/docs/framework/install/on-windows-7.md +++ b/docs/framework/install/on-windows-7.md @@ -1,5 +1,5 @@ --- -title: Installing the .NET Framework on Windows 7 SP1 +title: Install the .NET Framework on Windows 7 SP1 description: Learn how to install .NET Framework on Windows 7 SP1 author: rlander keywords: .NET Framework, Install @@ -12,13 +12,13 @@ ms.devlang: dotnet ms.assetid: 85cda1d5-c9a4-4eb5-93e6-4f878de07fd7 --- -# Installing the .NET Framework on Windows 7 SP1 +# Install the .NET Framework on Windows 7 SP1 You may need the .NET Framework to run an application on Windows 7 SP1. You can install the latest supported versions using the following instructions. The instructions depend on which version of the .NET Framework you need. ## .NET Framework 4.6.2 -You can install the [.NET Framework 4.6.2](https://go.microsoft.com/fwlink/?linkid=845529&source=dotnetdocs) or later on Windows 7. +You can install the [.NET Framework 4.6.2](https://go.microsoft.com/fwlink/?linkid=845529&source=dotnetdocs) or later on Windows 7. The .NET Framework 4.6.2 is included with [Windows 10 Anniversary Update](https://www.microsoft.com/software-download/windows10). @@ -32,4 +32,4 @@ The .NET Framework 3.5 can be used to run applications built for .NET Framework ## Help -You can [contact Microsoft for help](mailto:dotnet-install-help@microsoft.com?subject=Help installing .NET Framework) if you cannot get the correct version of the .NET Framework installed. \ No newline at end of file +You can [contact Microsoft for help](mailto:dotnet-install-help@microsoft.com?subject=Help installing .NET Framework) if you cannot get the correct version of the .NET Framework installed. diff --git a/docs/framework/install/on-windows-8.md b/docs/framework/install/on-windows-8.md index 043d0f183c8c7..3d1b448a39165 100644 --- a/docs/framework/install/on-windows-8.md +++ b/docs/framework/install/on-windows-8.md @@ -1,5 +1,5 @@ --- -title: Installing the .NET Framework on Windows 8 +title: Install the .NET Framework on Windows 8 description: Learn how to install .NET Framework on Windows 8 author: rlander keywords: .NET Framework, Install @@ -12,13 +12,13 @@ ms.devlang: dotnet ms.assetid: 85cda1d5-c9a4-4eb5-93e6-4f478de07ff7 --- -# Installing the .NET Framework on Windows 8 +# Install the .NET Framework on Windows 8 You may need the .NET Framework to run an application on Windows 8. You can use the following instructions to help you. The instructions depend on which version of the .NET Framework you need. ## .NET Framework 4.6.2 -You can install the [.NET Framework 4.6.2](https://go.microsoft.com/fwlink/?linkid=845529&source=dotnetdocs) or later on Windows 8. +You can install the [.NET Framework 4.6.2](https://go.microsoft.com/fwlink/?linkid=845529&source=dotnetdocs) or later on Windows 8. The .NET Framework 4.6.2 is included with [Windows 10 Anniversary Update](https://www.microsoft.com/software-download/windows10). diff --git a/docs/framework/install/on-windows-vista.md b/docs/framework/install/on-windows-vista.md index b0d1e9e02114e..7faa4f9f46dc7 100644 --- a/docs/framework/install/on-windows-vista.md +++ b/docs/framework/install/on-windows-vista.md @@ -12,7 +12,7 @@ ms.devlang: dotnet ms.assetid: 67cda1d5-c6g5-5eb5-93e6-5f478de07ff7 --- -# Installing the .NET Framework on Windows Vista +# Install the .NET Framework on Windows Vista You may need the .NET Framework to run an application on Windows Vista. You can use the following instructions to help you. The instructions depend on which version of the .NET Framework you need. diff --git a/docs/framework/install/on-windows-xp.md b/docs/framework/install/on-windows-xp.md index 23bcf042e0305..184506151872e 100644 --- a/docs/framework/install/on-windows-xp.md +++ b/docs/framework/install/on-windows-xp.md @@ -12,10 +12,10 @@ ms.devlang: dotnet ms.assetid: 87cda1d5-c8g5-5eb5-93e8-5f478de07ff7 --- -# Installing the .NET Framework on Windows XP +# Install the .NET Framework on Windows XP -> [!NOTE] -> Windows XP is no longer supported by Microsoft. We recommend you upgrade to Windows 10, which is supported and supports the latest version of the .NET Framework. This document is provided solely as a helpful troubleshooting guide. +> [!NOTE] +> Windows XP is no longer supported by Microsoft. We recommend you upgrade to Windows 10, which is supported and supports the latest version of the .NET Framework. This document is provided solely as a helpful troubleshooting guide. You may need the .NET Framework to run an application on Windows XP. You can use the following instructions to help you. The instructions depend on which version of the .NET Framework you need. diff --git a/docs/framework/install/repair.md b/docs/framework/install/repair.md index 1b018bb8ca65d..c9b8cc557e7d9 100644 --- a/docs/framework/install/repair.md +++ b/docs/framework/install/repair.md @@ -14,8 +14,8 @@ ms.assetid: 87cdb1d5-c5g8-8af9-93e8-5f478de07ff7 # Repair the .NET Framework -In some situations, your .NET Framework installation can become damaged and needs to be repaired. This might be the case if your app crashes right after you try to start it or if you cannot install newer .NET Framework versions. +In some situations, your .NET Framework installation can become damaged and require repairs. This might be the case if your app crashes right after you try to start it or if you cannot install newer .NET Framework versions. -You can repair your .NET Framework install using the [.NET Framework Repair Tool](http://download.microsoft.com/download/2/B/D/2BDE5459-2225-48B8-830C-AE19CAF038F1/NetFxRepairTool.exe). +You can repair your .NET Framework install using the [.NET Framework Repair Tool](http://download.microsoft.com/download/2/B/D/2BDE5459-2225-48B8-830C-AE19CAF038F1/NetFxRepairTool.exe). -If your app still isn't starting after repairing the .NET Framework, then the problem may be with the application. In that case, you should contact the application publisher. +If your app still isn't starting after repairing the .NET Framework, then the application might have a problem. In that case, you should contact the application publisher. diff --git a/docs/framework/install/run-net-framework-1-1-apps.md b/docs/framework/install/run-net-framework-1-1-apps.md index f87a2b99f0c11..942bea164ff65 100644 --- a/docs/framework/install/run-net-framework-1-1-apps.md +++ b/docs/framework/install/run-net-framework-1-1-apps.md @@ -1,5 +1,5 @@ --- -title: "Running .NET Framework 1.1 Apps on Windows 8, Windows 8.1 or Windows 10 | Microsoft Docs" +title: "Run .NET Framework 1.1 apps on Windows 8, Windows 8.1, or Windows 10 | Microsoft Docs" ms.custom: "" ms.date: "03/30/2017" ms.prod: ".net-framework" @@ -18,12 +18,16 @@ author: "mairaw" ms.author: "mairaw" manager: "wpickett" --- -# Running .NET Framework 1.1 Apps on Windows 8, Windows 8.1 or Windows 10 -The .NET Framework 1.1 is not supported on the [!INCLUDE[win8](../../../includes/win8-md.md)], [!INCLUDE[win81](../../../includes/win81-md.md)], [!INCLUDE[winserver8](../../../includes/winserver8-md.md)], [!INCLUDE[winblue_server_2](../../../includes/winblue-server-2-md.md)] or the Windows 10 operating systems. In some cases, the .NET Framework 1.1 is specifically identified as required for an application to run. In those cases, you should contact your independent software vendor (ISV) to have the application upgraded to run on the [!INCLUDE[net_v35SP1_short](../../../includes/net-v35sp1-short-md.md)] or later version. For additional information, see [Migrating from the .NET Framework 1.1](../../../docs/framework/migration-guide/migrating-from-the-net-framework-1-1.md). - -## Installing the .NET Framework 1.1 from a CD or Download Center - It is not possible to manually install the .NET Framework 1.1 on [!INCLUDE[win8](../../../includes/win8-md.md)], [!INCLUDE[win81](../../../includes/win81-md.md)], [!INCLUDE[winserver8](../../../includes/winserver8-md.md)], [!INCLUDE[winblue_server_2](../../../includes/winblue-server-2-md.md)] or Windows 10. It is no longer supported. If you try to install the package, the following error message is displayed: "Setup cannot continue because this version of the .NET Framework is incompatible with a previously installed one." To solve this problem, install the [.NET Framework 3.5 SP1](http://www.microsoft.com/download/details.aspx?id=22). This version includes the .NET Framework 2.0 (the release that follows the .NET Framework 1.1), which is supported on [!INCLUDE[win8](../../../includes/win8-md.md)], [!INCLUDE[win81](../../../includes/win81-md.md)] and Windows 10. You should always try to install the application first to determine if it will automatically be updated to a later version of the .NET Framework. If it does not, contact your ISV for an application update. - -## See Also - [Migrating from the .NET Framework 1.1](../../../docs/framework/migration-guide/migrating-from-the-net-framework-1-1.md) - [Installing the .NET Framework 3.5 on Windows 8 and later versions](../../../docs/framework/install/net-framework-3-5-on-windows-8-plus.md) \ No newline at end of file + +# Run .NET Framework 1.1 apps on Windows 8, Windows 8.1, or Windows 10 + +The .NET Framework 1.1 is not supported on the [!INCLUDE[win8](../../../includes/win8-md.md)], [!INCLUDE[win81](../../../includes/win81-md.md)], [!INCLUDE[winserver8](../../../includes/winserver8-md.md)], [!INCLUDE[winblue_server_2](../../../includes/winblue-server-2-md.md)], or the Windows 10 operating systems. In some cases, the .NET Framework 1.1 is specifically identified as required for an application to run. In those cases, you should contact your independent software vendor (ISV) to have the application upgraded to run on the [!INCLUDE[net_v35SP1_short](../../../includes/net-v35sp1-short-md.md)] or later version. For additional information, see [Migrating from the .NET Framework 1.1](../../../docs/framework/migration-guide/migrating-from-the-net-framework-1-1.md). + +## Install the .NET Framework 1.1 from a CD or Download Center + +It isn't possible to manually install the .NET Framework 1.1 on [!INCLUDE[win8](../../../includes/win8-md.md)], [!INCLUDE[win81](../../../includes/win81-md.md)], [!INCLUDE[winserver8](../../../includes/winserver8-md.md)], [!INCLUDE[winblue_server_2](../../../includes/winblue-server-2-md.md)], or Windows 10. It is no longer supported. If you try to install the package, the following error message is displayed: "Setup cannot continue because this version of the .NET Framework is incompatible with a previously installed one." To solve this problem, install the [.NET Framework 3.5 SP1](http://www.microsoft.com/download/details.aspx?id=22). This version includes the .NET Framework 2.0 (the release that follows the .NET Framework 1.1), which is supported on [!INCLUDE[win8](../../../includes/win8-md.md)], [!INCLUDE[win81](../../../includes/win81-md.md)], and Windows 10. You should always try to install the application first to determine if it will automatically be updated to a later version of the .NET Framework. If it does not, contact your ISV for an application update. + +## See also + +[Migrating from the .NET Framework 1.1](../../../docs/framework/migration-guide/migrating-from-the-net-framework-1-1.md) +[Install the .NET Framework 3.5 on Windows 10, Windows 8.1, and Windows 8](../../../docs/framework/install/dotnet-35-windows-10.md) \ No newline at end of file diff --git a/docs/framework/install/toc.md b/docs/framework/install/toc.md index 105fb1259236a..82ea9e5d69131 100644 --- a/docs/framework/install/toc.md +++ b/docs/framework/install/toc.md @@ -1,4 +1,12 @@ -# [Installation Guide](index.md) -## [Installing the .NET Framework 3.5 on Windows 8 and later versions](net-framework-3-5-on-windows-8-plus.md) -## [Running .NET Framework 1.1 Apps on Windows 8 and later versions](run-net-framework-1-1-apps.md) -## [Troubleshooting](troubleshoot-blocked-installations-and-uninstallations.md) +# [Installation guide](index.md) +## [Install the .NET Framework on Windows 10](on-windows-10.md) +## [Install the .NET Framework on Windows 8](on-windows-8.md) +## [Install the .NET Framework on Windows 7 SP1](on-windows-7.md) +## [Install the .NET Framework on Windows Vista](on-windows-vista.md) +## [Install the .NET Framework on Windows XP](on-windows-xp.md) +## [Installation guide for developers](guide-for-developers.md) +## [Repair the .NET Framework](repair.md) +## [Troubleshoot blocked .NET Framework installations and uninstallations](troubleshoot-blocked-installations-and-uninstallations.md) +## [Install the .NET Framework 3.5 on Windows 10, Windows 8.1, and Windows 8](dotnet-35-windows-10.md) +### [Troubleshoot the installation of the .NET Framework 3.5](net-framework-3-5-on-windows-8-plus.md) +## [Run .NET Framework 1.1 apps on Windows 8, Windows 8.1, or Windows 10](run-net-framework-1-1-apps.md) diff --git a/docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md b/docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md index 0e2e01156b019..e244622bb10e9 100644 --- a/docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md +++ b/docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md @@ -1,5 +1,5 @@ --- -title: "Troubleshooting Blocked .NET Framework Installations and Uninstallations | Microsoft Docs" +title: "Troubleshoot blocked .NET Framework installations and uninstallations | Microsoft Docs" ms.custom: "" ms.date: "03/30/2017" ms.prod: ".net-framework" @@ -18,18 +18,20 @@ author: "rpetrusha" ms.author: "ronpet" manager: "wpickett" --- -# Troubleshooting Blocked .NET Framework Installations and Uninstallations -When you run the [web or offline installer](../../../docs/framework/install/guide-for-developers.md) for the .NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, or 4.7, you might encounter an issue that prevents or blocks the installation of the .NET Framework. The following table lists possible blocking issues and provides links to troubleshooting information. - - In Windows 8 and above, the .NET Framework is an operating system component and cannot be independently uninstalled. Updates to the .NET Framework appear in the **Installed Updates** tab of the Control Panel **Programs and Features** app. For operating systems on which the .NET Framework is not preinstalled, the .NET Framework appears in the **Uninstall or change a program** tab (or the **Add/Remove programs** tab) of the **Program and Features** app in Control Panel. For information on the Windows versions on which the .NET Framework is preinstalled, see [System Requirements](../../../docs/framework/get-started/system-requirements.md). + +# Troubleshoot blocked .NET Framework installations and uninstallations + +When you run the [web or offline installer](../../../docs/framework/install/guide-for-developers.md) for the .NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, or 4.7 you might encounter an issue that prevents or blocks the installation of the .NET Framework. The following table lists possible blocking issues and provides links to troubleshooting information. + +In Windows 8 and above, the .NET Framework is an operating system component and cannot be independently uninstalled. Updates to the .NET Framework appear in the **Installed Updates** tab of the Control Panel **Programs and Features** app. For operating systems on which the .NET Framework is not preinstalled, the .NET Framework appears in the **Uninstall or change a program** tab (or the **Add/Remove programs** tab) of the **Program and Features** app in Control Panel. For information on the Windows versions on which the .NET Framework is preinstalled, see [System Requirements](../../../docs/framework/get-started/system-requirements.md). > [!IMPORTANT] -> Because the 4.x versions of the .NET Framework are in-place updates, you cannot install an earlier version of the .NET Framework 4.x on a system with that already has a later version installed. For example, on a system with Windows 10 Creators Update, you cannot install the .NET Framework 4.6.2, since the .NET Framework 4.7 is preinstalled with the operating system. - - You can determine which versions of the .NET Framework are installed on a system. See [How to: Determine Which .NET Framework Versions Are Installed](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md) for more information. - - In this table, 4.5.*x* refers to the .NET Framework 4.5 and its point releases, 4.5.1, and 4.5.2, 4.6.*x* refers to the .NET Framework 4.6 and its point releases, 4.6.1 and 4.6.2, and 4.7 refers to the .NET Framework 4.7. - +> Because the 4.x versions of the .NET Framework are in-place updates, you cannot install an earlier version of the .NET Framework 4.x on a system with that already has a later version installed. For example, on a system with Windows 10 Creators Update, you cannot install the .NET Framework 4.6.2, since the .NET Framework 4.7 is preinstalled with the operating system. + +You can determine which versions of the .NET Framework are installed on a system. See [How to: Determine Which .NET Framework Versions Are Installed](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md) for more information. + +In this table, 4.5.*x* refers to the .NET Framework 4.5 and its point releases, 4.5.1, and 4.5.2, 4.6.*x* refers to the .NET Framework 4.6 and its point releases, 4.6.1 and 4.6.2, and 4.7 refers to the .NET Framework 4.7. + |Blocking message|For more information or to resolve the issue| |----------------------|--------------------------------------------------| |Uninstalling the Microsoft .NET Framework may cause some applications to cease to function.|In general, you should not uninstall any versions of the .NET Framework that are installed on your computer, because an application you use may depend on a specific version of the .NET Framework. For more information, see [The .NET Framework for users](../../../docs/framework/get-started/index.md#ForUsers) in the *Getting Started* guide.| @@ -38,7 +40,7 @@ When you run the [web or offline installer](../../../docs/framework/install/guid |Cannot install the .NET Framework 4.5*.x*/4.6*.x*/4.7. Other applications on your computer are not compatible with this program.

-or-

Other applications on your computer are not compatible with this program.|The most likely cause of this message is that a preview or RC version of the .NET Framework was installed. Uninstall the preview or RC version and rerun Setup.| |.NET Framework 4.5*.x*/4.6*.x*/4.7 cannot be uninstalled using this package. To uninstall .NET Framework 4.5*.x*/4.6*.x* from your computer, go to **Control Panel**, choose **Programs and Features**, choose **View installed updates**, select Update for Microsoft Windows (KB2828152) and then choose **Uninstall**.|The package you are installing doesn't uninstall preview or RC releases of the .NET Framework.

Uninstall the preview or RC release from Control Panel.| |Cannot uninstall the .NET Framework 4.5*.x*/4.6*.x*/4.7. Other applications on your computer are dependent on this program.|In general, you shouldn't uninstall any versions of the .NET Framework from your computer, because an application you use may depend on a specific version of the .NET Framework. For more information, see [The .NET Framework for users](../../../docs/framework/get-started/index.md#ForUsers) in the *Getting Started* guide.| -|The .NET Framework 4.5*.x*/4.6*.x*/4.7 redistributable does not apply to this operating system. Please download the .NET Framework 4.5*.x*/4.6*.x* for your operating system from the Microsoft Download Center.|You may be trying to install the [!INCLUDE[net_v451](../../../includes/net-v451-md.md)], 4.5.2, 4.6, 4.6.1, 4.6.2, or 4.7 on a platform that isn't supported, or you have chosen the installation package that does not include the components for all supported operating systems. Run the installation again by using the offline installer ([for 4.5.1](http://go.microsoft.com/fwlink/p/?LinkId=309493), [for 4.5.2](http://go.microsoft.com/fwlink/p/?LinkId=397706), [for 4.6](http://go.microsoft.com/fwlink/p/?LinkId=528233), [for 4.6.1](http://go.microsoft.com/fwlink/p/?LinkId=671744), for [4.6.2](http://go.microsoft.com/fwlink/p/?LinkId=780604)), or for [4.7](http://go.microsoft.com/fwlink/p/?LinkId=825306). For more information, see the [installation guide](../../../docs/framework/install/guide-for-developers.md) and [system requirements](../../../docs/framework/get-started/system-requirements.md) for supported operating systems.| +|The .NET Framework 4.5*.x*/4.6*.x*/4.7 redistributable does not apply to this operating system. Please download the .NET Framework 4.5*.x*/4.6*.x* for your operating system from the Microsoft Download Center.|You may be trying to install the [!INCLUDE[net_v451](../../../includes/net-v451-md.md)], 4.5.2, 4.6, 4.6.1, 4.6.2, or 4.7 on a platform that isn't supported, or you have chosen the installation package that does not include the components for all supported operating systems. Run the installation again by using the offline installer ([for 4.5.1](http://go.microsoft.com/fwlink/p/?LinkId=309493), [for 4.5.2](http://go.microsoft.com/fwlink/p/?LinkId=397706), [for 4.6](http://go.microsoft.com/fwlink/p/?LinkId=528233), [for 4.6.1](http://go.microsoft.com/fwlink/p/?LinkId=671744), for [4.6.2](http://go.microsoft.com/fwlink/p/?LinkId=780604), or for [4.7](http://go.microsoft.com/fwlink/p/?LinkId=825306)). For more information, see the [installation guide](../../../docs/framework/install/guide-for-developers.md) and [system requirements](../../../docs/framework/get-started/system-requirements.md) for supported operating systems.| |The update corresponding to KB\<*number*> needs to be installed before you can install this product.|Installation of the .NET Framework requires that a KB update be installed before installing the .NET Framework. Install the update, and then begin the .NET Framework installation again.

For example, installation of updated versions of the .NET Framework on Windows 8.1, Windows RT 8.1, and Windows Server 2012 R2 requires that the update corresponding to [KB 2919355](https://support.microsoft.com/kb/2919355) be installed.| |Your computer is currently running a Server Core installation of the Windows Server 2008 operating system. The .NET Framework 4.5.*x* requires a later release of the operating system. Please install Windows Server 2008 R2 SP1 or higher and rerun .NET Framework 4.5.*x* setup.|The [!INCLUDE[net_v451](../../../includes/net-v451-md.md)] and 4.5.2 are supported in the Server Core role with Windows Server 2008 R2 SP1 or later. See [System Requirements](../../../docs/framework/get-started/system-requirements.md).| |You do not have sufficient privileges to complete this operation for all users of this computer. Log on as an administrator and rerun **Setup**.|You must be an administrator on the computer to install the .NET Framework.| @@ -55,28 +57,31 @@ When you run the [web or offline installer](../../../docs/framework/install/guid |The .NET Framework 4.5.*x* is already a part of this operating system but is currently turned off ([!INCLUDE[winserver8](../../../includes/winserver8-md.md)] only).|See [Turn Windows features on or off](http://go.microsoft.com/fwlink/p/?LinkId=248438) on the Windows website.| |This setup program requires an x86 computer. It cannot be installed on x64 or IA64 computers.|See [System Requirements](../../../docs/framework/get-started/system-requirements.md) in the MSDN Library.| |This setup program requires x64 or x86 computer. It cannot be installed on IA64 computers.|See [System Requirements](../../../docs/framework/get-started/system-requirements.md) in the MSDN Library.| - - -### Program compatibility issues - The installation of the .NET Framework 4.5 or its point releases fails with a 1603 error code or blocks when it is running in Windows Program Compatibility mode. The **Program Compatibility Assistant** indicates that the .NET Framework might not have been installed correctly, and prompts you to reinstall it by using the recommended setting (Program Compatibility mode). Program Compatibility mode could also have been set by the Program Compatibility Assistant on earlier failed or canceled attempts to run the .NET Framework Setup. - - The .NET Framework installer cannot run in Program Compatibility mode. To resolve this blocking issue, you must ensure that the compatibility mode setting is not enabled systemwide in Registry Editor: - -1. Choose the **Start** button, and then choose **Run**. - -2. In the **Run** dialog box, type `regedit`, and then choose **OK**. - -3. In Registry Editor, browse to the following subkeys: - - - HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows NT\CurrentVersion\AppCompatFlags\Compatibility Assistant\Persisted - - - HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows NT\CurrentVersion\AppCompatFlags\Layers - -4. In the Name column, look for the [!INCLUDE[net_v45](../../../includes/net-v45-md.md)], 4.5.1, 4.5.2, 4.6, 4.6.1, or 4.6.2 download names, depending on which version you are installing, and delete these entries. For download names, see the [Installation Guide](../../../docs/framework/install/guide-for-developers.md) article. - -5. Rerun the .NET Framework installer for version 4.5, 4.5.1, 4.5.2, or 4.6, 4.6.1, 4.6.2, or 4.7. - -## See Also - [Installation Guide](../../../docs/framework/install/guide-for-developers.md) - [How to: Determine Which .NET Framework Versions Are Installed](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md) - [Versions and Dependencies](../../../docs/framework/migration-guide/versions-and-dependencies.md) \ No newline at end of file + + +### Program compatibility issues + +The installation of the .NET Framework 4.5 or its point releases fails with a 1603 error code or blocks when it's running in Windows Program Compatibility mode. The **Program Compatibility Assistant** indicates that the .NET Framework might not have been installed correctly and prompts you to reinstall it by using the recommended setting (Program Compatibility mode). Program Compatibility mode could also have been set by the Program Compatibility Assistant on earlier failed or canceled attempts to run the .NET Framework Setup. + +The .NET Framework installer cannot run in Program Compatibility mode. To resolve this blocking issue, you must ensure that the compatibility mode setting is not enabled systemwide in Registry Editor: + +1. Choose the **Start** button, and then choose **Run**. + +1. In the **Run** dialog box, type "regedit", and then choose **OK**. + +1. In Registry Editor, browse to the following subkeys: + + - HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows NT\CurrentVersion\AppCompatFlags\Compatibility Assistant\Persisted + + - HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows NT\CurrentVersion\AppCompatFlags\Layers + +1. In the Name column, look for the [!INCLUDE[net_v45](../../../includes/net-v45-md.md)], 4.5.1, 4.5.2, 4.6, 4.6.1, or 4.6.2 download names, depending on which version you are installing, and delete these entries. For download names, see [Install the .NET Framework for developers](../../../docs/framework/install/guide-for-developers.md) article. + +1. Rerun the .NET Framework installer for version 4.5, 4.5.1, 4.5.2, or 4.6, 4.6.1, 4.6.2, or 4.7. + +## See also + +[Install the .NET Framework for developers](../../../docs/framework/install/guide-for-developers.md) +[How to: Determine Which .NET Framework Versions Are Installed](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md) +[Versions and Dependencies](../../../docs/framework/migration-guide/versions-and-dependencies.md) + diff --git a/docs/framework/migration-guide/how-to-determine-which-net-framework-updates-are-installed.md b/docs/framework/migration-guide/how-to-determine-which-net-framework-updates-are-installed.md index 7968e666b5a4d..1f523294df8eb 100644 --- a/docs/framework/migration-guide/how-to-determine-which-net-framework-updates-are-installed.md +++ b/docs/framework/migration-guide/how-to-determine-which-net-framework-updates-are-installed.md @@ -21,7 +21,7 @@ manager: "wpickett" # How to: Determine Which .NET Framework Updates Are Installed The installed updates for each version of the .NET Framework installed on a computer are listed in the Windows registry. You can use the Registry Editor (regedit.exe) to view this information. - In the Registry Editor, the .NET Framework versions and installed updates for each version are stored in different subkeys. For information about detecting the installed version numbers, see [How to: Determine Which .NET Framework Versions Are Installed](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md). For information about installing the .NET Framework, see the [installation guide](../../../docs/framework/install/guide-for-developers.md). + In the Registry Editor, the .NET Framework versions and installed updates for each version are stored in different subkeys. For information about detecting the installed version numbers, see [How to: Determine Which .NET Framework Versions Are Installed](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md). For information about installing the .NET Framework, see [Install the .NET Framework for developers](../../../docs/framework/install/guide-for-developers.md). ### To find installed updates @@ -71,7 +71,8 @@ Microsoft .NET Framework 4 Extended ``` -## See Also - [How to: Determine Which .NET Framework Versions Are Installed](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md) - [Installation Guide](../../../docs/framework/install/guide-for-developers.md) - [Versions and Dependencies](../../../docs/framework/migration-guide/versions-and-dependencies.md) +## See also + +[How to: Determine Which .NET Framework Versions Are Installed](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md) +[Installing the .NET Framework](../../../docs/framework/install/guide-for-developers.md) +[Versions and Dependencies](../../../docs/framework/migration-guide/versions-and-dependencies.md) diff --git a/docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md b/docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md index 4d3d357db72c4..4a3d5170101eb 100644 --- a/docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md +++ b/docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md @@ -18,41 +18,42 @@ author: "rpetrusha" ms.author: "ronpet" manager: "wpickett" --- -# How to: Determine which .NET Framework versions are installed -Users can install and run multiple versions of the .NET Framework on their computers. When you develop or deploy your app, you might need to know which .NET Framework versions are installed on the user’s computer. Note that the .NET Framework consists of two main components, which are versioned separately: - -- A set of assemblies, which are collections of types and resources that provide the functionality for your apps. The .NET Framework and assemblies share the same version number. - -- The common language runtime (CLR), which manages and executes your app's code. The CLR is identified by its own version number (see [Versions and Dependencies](~/docs/framework/migration-guide/versions-and-dependencies.md)). - - To get an accurate list of the .NET Framework versions installed on a computer, you can view the registry or query the registry in code: - - [Viewing the registry (versions 1-4)](#net_a) - [Viewing the registry (version 4.5 and later)](#net_b) - [Using code to query the registry (versions 1-4)](#net_c) - [Using code to query the registry (version 4.5 and later)](#net_d) - - To find the CLR version, you can use a tool or code: - - [Using the Clrver tool](#clr_a) - [Using code to query the System.Environment class](#clr_b) - - For information about detecting the installed updates for each version of the .NET Framework, see [How to: Determine Which .NET Framework Updates Are Installed](~/docs/framework/migration-guide/how-to-determine-which-net-framework-updates-are-installed.md). For information about installing the .NET Framework, see the [installation guide](../../../docs/framework/install/guide-for-developers.md). - - -#### To find .NET Framework versions by viewing the registry (.NET Framework 1-4) - -1. On the **Start** menu, choose **Run**. - -2. In the **Open** box, enter **regedit.exe**. - - You must have administrative credentials to run regedit.exe. - -3. In the Registry Editor, open the following subkey: - - `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP` - - The installed versions are listed under the NDP subkey. The version number is stored in the **Version** entry. For the [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] the **Version** entry is under the Client or Full subkey (under NDP), or under both subkeys. +# How to: Determine Which .NET Framework Versions Are Installed +Users can install and run multiple versions of the .NET Framework on their computers. When you develop or deploy your app, you might need to know which .NET Framework versions are installed on the user’s computer. Note that the .NET Framework consists of two main components, which are versioned separately: + +- A set of assemblies, which are collections of types and resources that provide the functionality for your apps. The .NET Framework and assemblies share the same version number. + +- The common language runtime (CLR), which manages and executes your app's code. The CLR is identified by its own version number (see [Versions and Dependencies](~/docs/framework/migration-guide/versions-and-dependencies.md)). + + To get an accurate list of the .NET Framework versions installed on a computer, you can view the registry or query the registry in code: + + [Viewing the registry (versions 1-4)](#net_a) + [Viewing the registry (version 4.5 and later)](#net_b) + [Using code to query the registry (versions 1-4)](#net_c) + [Using code to query the registry (version 4.5 and later)](#net_d) + + To find the CLR version, you can use a tool or code: + + [Using the Clrver tool](#clr_a) + [Using code to query the System.Environment class](#clr_b) + + For information about detecting the installed updates for each version of the .NET Framework, see [How to: Determine Which .NET Framework Updates Are Installed](~/docs/framework/migration-guide/how-to-determine-which-net-framework-updates-are-installed.md). For information about installing the .NET Framework, see [Install the .NET Framework for developers](../../../docs/framework/install/guide-for-developers.md). + + +#### To find .NET Framework versions by viewing the registry (.NET Framework 1-4) + +1. On the **Start** menu, choose **Run**. + +2. In the **Open** box, enter **regedit.exe**. + + You must have administrative credentials to run regedit.exe. + +3. In the Registry Editor, open the following subkey: + + `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP` + + The installed versions are listed under the NDP subkey. The version number is stored in the **Version** entry. For the [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] the **Version** entry is under the Client or Full subkey (under NDP), or under both subkeys. + > [!NOTE] > The "NET Framework Setup" folder in the registry does not begin with a period. @@ -187,5 +188,5 @@ Users can install and run multiple versions of the .NET Framework on their compu ## See Also [How to: Determine Which .NET Framework Updates Are Installed](~/docs/framework/migration-guide/how-to-determine-which-net-framework-updates-are-installed.md) - [Installation Guide](../../../docs/framework/install/guide-for-developers.md) + [Install the .NET Framework for developers](../../../docs/framework/install/guide-for-developers.md) [Versions and Dependencies](~/docs/framework/migration-guide/versions-and-dependencies.md) \ No newline at end of file diff --git a/docs/framework/migration-guide/versions-and-dependencies.md b/docs/framework/migration-guide/versions-and-dependencies.md index 769b8dfb07777..c22f341b3f23f 100644 --- a/docs/framework/migration-guide/versions-and-dependencies.md +++ b/docs/framework/migration-guide/versions-and-dependencies.md @@ -21,15 +21,15 @@ manager: "wpickett" Each version of the .NET Framework contains the common language runtime (CLR), the base class libraries, and other managed libraries. This topic describes the key features of the .NET Framework by version, provides information about the underlying CLR versions and associated development environments, and identifies the versions that are installed by the Windows operating system. > [!NOTE] -> For information on downloading and installing the .NET Framework, see [Installation Guide](../../../docs/framework/install/guide-for-developers.md). +> For information on downloading and installing the .NET Framework, see [Install the .NET Framework for developers](../../../docs/framework/install/guide-for-developers.md). The following table summarizes .NET Framework version history and correlates each version with Visual Studio, Windows, and Windows Server. Note that Visual Studio provides multi-targeting, so you are not limited to the version of the .NET Framework that is listed. Each new version of the .NET Framework retains features from the previous versions and adds new features. The CLR is identified by its own version number. The .NET Framework version number is incremented at each release, although the CLR version is not always incremented. For example, the .NET Framework 4, 4.5, and later releases include CLR 4, but the .NET Framework 2.0, 3.0, and 3.5 include CLR 2.0. (There was no version 3 of the CLR.) - See [System Requirements](../../../docs/framework/get-started/system-requirements.md) for a complete list of supported operating systems. For downloads, see the [installation guide](../../../docs/framework/install/guide-for-developers.md). For determining which version(s) of the .NET Framework is installed on a computer, see [How to: Determine Which .NET Framework Versions Are Installed](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md). + See [System Requirements](../../../docs/framework/get-started/system-requirements.md) for a complete list of supported operating systems. For downloads, see [Install the .NET Framework for developers](../../../docs/framework/install/guide-for-developers.md). For determining which version(s) of the .NET Framework is installed on a computer, see [How to: Determine Which .NET Framework Versions Are Installed](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md). - In the table, versions of the .NET Framework that are installed on operating system versions marked with ✓ in the **Included in/Can be installed on Windows** and the **Included in/Can be installed on Windows Server** columns must be [enabled in Control Panel](../../../docs/framework/install/net-framework-3-5-on-windows-8-plus.md) (for Windows) or enabled through the Server Manager (for Windows Server). + In the table, versions of the .NET Framework that are installed on operating system versions marked with ✓ in the **Included in/Can be installed on Windows** and the **Included in/Can be installed on Windows Server** columns must be [enabled in Control Panel](../../../docs/framework/install/dotnet-35-windows-10.md) (for Windows) or enabled through the Server Manager (for Windows Server). |.NET Framework version|CLR version|Features|Included in Visual Studio version|✓ Included in
+ Can be installed on
Windows|✓ Included in
+ Can be installed on
Windows Server|To determine installed .NET version| |----------------------------|-----------------|--------------|---------------------------------------|----------------------------------------------------|-----------------------------------------------------------|-----------------------------------------| @@ -58,12 +58,12 @@ Each version of the .NET Framework contains the common language runtime (CLR), t The[!INCLUDE[net_v451](../../../includes/net-v451-md.md)] and [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] are used here only as examples. This principle applies to any app that targets an a later version of the .NET Framework than the one installed on the system on which it is running. - Some changes in the .NET Framework may require changes to your app code; see [Application Compatibility](../../../docs/framework/migration-guide/application-compatibility.md) before you run your existing apps with the [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] or later versions. For more information about installing the current version, see [Installation Guide](../../../docs/framework/install/guide-for-developers.md). For information about support for the .NET Framework, see [Microsoft .NET Framework Support Lifecycle Policy](http://go.microsoft.com/fwlink/?LinkId=196607) on the Microsoft Support website. + Some changes in the .NET Framework may require changes to your app code; see [Application Compatibility](../../../docs/framework/migration-guide/application-compatibility.md) before you run your existing apps with the [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] or later versions. For more information about installing the current version, see [Install the .NET Framework for developers](../../../docs/framework/install/guide-for-developers.md). For information about support for the .NET Framework, see [Microsoft .NET Framework Support Lifecycle Policy](http://go.microsoft.com/fwlink/?LinkId=196607) on the Microsoft Support website. ## Targeting and running apps for older versions The .NET Framework versions 2.0, 3.0, and 3.5 are built with the same version of the CLR (CLR 2.0). These versions represent successive layers of a single installation. Each version is built incrementally on top of the earlier versions. It is not possible to run versions 2.0, 3.0, and 3.5 side by side on a computer. When you install version 3.5, you get the 2.0 and 3.0 layers automatically, and apps that were built for versions 2.0, 3.0, and 3.5 can all run on version 3.5. However, the .NET Framework 4 ends this layering approach. Starting with the .NET Framework 4, you can use in-process side-by-side hosting to run multiple versions of the CLR in a single process. For more information, see [Assemblies and Side-by-Side Execution](../../../docs/framework/app-domains/assemblies-and-side-by-side-execution.md). - In addition, if your app targets version 2.0, 3.0, or 3.5, your users may be required to enable the .NET Framework 3.5 on a [!INCLUDE[win8](../../../includes/win8-md.md)] or [!INCLUDE[win81](../../../includes/win81-md.md)] computer before they can run your app. For more information, see [Installing the .NET Framework 3.5 on Windows 8 and later versions](../../../docs/framework/install/net-framework-3-5-on-windows-8-plus.md). + In addition, if your app targets version 2.0, 3.0, or 3.5, your users may be required to enable the .NET Framework 3.5 on a [!INCLUDE[win8](../../../includes/win8-md.md)] or [!INCLUDE[win81](../../../includes/win81-md.md)] computer before they can run your app. For more information, see [Install the .NET Framework 3.5 on Windows 10, Windows 8.1, and Windows 8](../../../docs/framework/install/dotnet-35-windows-10.md). ## Next steps @@ -75,7 +75,8 @@ Each version of the .NET Framework contains the common language runtime (CLR), t - For information about determining which versions or updates are installed on a computer, see [How to: Determine Which .NET Framework Versions Are Installed](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md) and [How to: Determine Which .NET Framework Updates Are Installed](../../../docs/framework/migration-guide/how-to-determine-which-net-framework-updates-are-installed.md). -## See Also - [Version Compatibility](../../../docs/framework/migration-guide/version-compatibility.md) - [Microsoft .NET Framework Support Lifecycle Policy](http://go.microsoft.com/fwlink/?LinkId=196607) - [Troubleshooting](../../../docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md) +## See also + +[Version Compatibility](../../../docs/framework/migration-guide/version-compatibility.md) +[Microsoft .NET Framework Support Lifecycle Policy](http://go.microsoft.com/fwlink/?LinkId=196607) +[Troubleshoot blocked .NET Framework installations and uninstallations](../../../docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md) diff --git a/docs/framework/whats-new/index.md b/docs/framework/whats-new/index.md index 43e657833aa5e..2c803d9871f2a 100644 --- a/docs/framework/whats-new/index.md +++ b/docs/framework/whats-new/index.md @@ -17,25 +17,27 @@ author: "rpetrusha" ms.author: "ronpet" manager: "wpickett" --- -# What's new in the .NET Framework - This article summarizes key new features and improvements in the following versions of the .NET Framework: - [.NET Framework 4.7](#v47) - [.NET Framework 4.6.2](#v462) - [.NET Framework 4.6.1](#v461) - [.NET 2015 and .NET Framework 4.6](#v46) - [.NET Framework 4.5.2](#v452) - [.NET Framework 4.5.1](#v451) - [.NET Framework 4.5](#core) +# What's new in the .NET Framework +This article summarizes key new features and improvements in the following versions of the .NET Framework: + +[.NET Framework 4.7](#v47) +[.NET Framework 4.6.2](#v462) +[.NET Framework 4.6.1](#v461) +[.NET 2015 and .NET Framework 4.6](#v46) +[.NET Framework 4.5.2](#v452) +[.NET Framework 4.5.1](#v451) +[.NET Framework 4.5](#core) - This article does not provide comprehensive information about each new feature and is subject to change. For general information about the .NET Framework, see [Getting Started](../../../docs/framework/get-started/index.md). For supported platforms, see [System Requirements](~/docs/framework/get-started/system-requirements.md). For download links and installation instructions, see [Installation Guide](../../../docs/framework/install/guide-for-developers.md). +This article does not provide comprehensive information about each new feature and is subject to change. For general information about the .NET Framework, see [Getting Started](../../../docs/framework/get-started/index.md). For supported platforms, see [System Requirements](~/docs/framework/get-started/system-requirements.md). For download links and installation instructions, see [Installation Guide](../../../docs/framework/install/guide-for-developers.md). > [!NOTE] -> The .NET Framework team also releases features out of band with NuGet to expand platform support and to introduce new functionality, such as immutable collections and SIMD-enabled vector types. For more information, see [Additional Class Libraries and APIs](../additional-apis/index.md) and [The .NET Framework and Out-of-Band Releases](~/docs/framework/get-started/the-net-framework-and-out-of-band-releases.md). See a [complete list of NuGet packages](https://blogs.msdn.microsoft.com/dotnet/p/nugetpackages/) for the .NET Framework, or subscribe to [our feed](https://nuget.org/api/v2/curated-feeds/dotnetframework/Packages/). +> The .NET Framework team also releases features out of band with NuGet to expand platform support and to introduce new functionality, such as immutable collections and SIMD-enabled vector types. For more information, see [Additional Class Libraries and APIs](../additional-apis/index.md) and [The .NET Framework and Out-of-Band Releases](~/docs/framework/get-started/the-net-framework-and-out-of-band-releases.md). See a [complete list of NuGet packages](https://blogs.msdn.microsoft.com/dotnet/p/nugetpackages/) for the .NET Framework, or subscribe to [our feed](https://nuget.org/api/v2/curated-feeds/dotnetframework/Packages/). ## Introducing the .NET Framework 4.7 - The .NET Framework 4.7 builds on the .NET Framework 4.6, 4.6.1, and 4.6.2 by adding many new fixes and several new features while remaining a very stable product. + +The .NET Framework 4.7 builds on the .NET Framework 4.6, 4.6.1, and 4.6.2 by adding many new fixes and several new features while remaining a very stable product. ### Downloading and installing the .NET Framework 4.7 @@ -153,7 +155,8 @@ WPF's printing APIs in the ## What's new in the .NET Framework 4.6.2 - The [!INCLUDE[net_v462](../../../includes/net-v462-md.md)] includes new features in the following areas: + +The [!INCLUDE[net_v462](../../../includes/net-v462-md.md)] includes new features in the following areas: - [ASP.NET](#ASPNET462) @@ -213,9 +216,9 @@ End Class You can then create a resource file, DataAnnotation.Localization.fr.resx, whose key is the error message string and whose value is the localized error message. The file must be found in the `App.LocalResources` folder. For example, the following is the key and its value in a localized French (fr) language error message: -|Name|Value| -|----------|-----------| -|The rating must be between 1 and 10.|La note doit être comprise entre 1 et 10.| +| Name | Value | +| ------------------------------------ | ----------------------------------------- | +| The rating must be between 1 and 10. | La note doit être comprise entre 1 et 10. | This file can then @@ -225,12 +228,10 @@ End Class ASP.NET now allows task-returning methods to be used with session-state store providers, thereby allowing ASP.NET apps to get the scalability benefits of async. To supports asynchronous operations with session state store providers, ASP.NET includes a new interface, , which inherits from and allows developers to implement their own session-state module and async session store providers. The interface is defined as follows: ```csharp - public interface ISessionStateModule : IHttpModule { void ReleaseSessionState(HttpContext context); Task ReleaseSessionStateAsync(HttpContext context); } - ``` In addition, the class includes two new methods, and , that can be used to support asynchronous operations. diff --git a/docs/framework/wpf/app-development/how-to-detect-whether-the-net-framework-3-5-is-installed.md b/docs/framework/wpf/app-development/how-to-detect-whether-the-net-framework-3-5-is-installed.md index 040b5daa26d6c..dd596e2b62769 100644 --- a/docs/framework/wpf/app-development/how-to-detect-whether-the-net-framework-3-5-is-installed.md +++ b/docs/framework/wpf/app-development/how-to-detect-whether-the-net-framework-3-5-is-installed.md @@ -24,7 +24,7 @@ manager: "wpickett" Before administrators can deploy [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] applications on a system that targets the [!INCLUDE[net_v35_short](../../../../includes/net-v35-short-md.md)], they must first confirm that the [!INCLUDE[net_v35_short](../../../../includes/net-v35-short-md.md)] runtime is present. This topic provides a script written in HTML/JavaScript that administrators can use to determine whether the [!INCLUDE[net_v35_short](../../../../includes/net-v35-short-md.md)] is present on a system. > [!NOTE] -> For more detailed information on installing, deploying, and detecting the [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)], see [Installing the .NET Framework](../../../../docs/framework/install/guide-for-developers.md). +> For more detailed information on installing, deploying, and detecting the [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)], see [Install the .NET Framework for developers](../../../../docs/framework/install/guide-for-developers.md). ## Example When the [!INCLUDE[net_v35_short](../../../../includes/net-v35-short-md.md)] is installed, the MSI adds ".NET CLR" and the version number to the UserAgent string. The following example shows a script embedded in a simple HTML page. The script searches the UserAgent string to determine whether the [!INCLUDE[net_v35_short](../../../../includes/net-v35-short-md.md)] is installed, and displays a status message on the results of the search. diff --git a/docs/framework/wpf/app-development/how-to-detect-whether-the-wpf-plug-in-for-firefox-is-installed.md b/docs/framework/wpf/app-development/how-to-detect-whether-the-wpf-plug-in-for-firefox-is-installed.md index 417b73b0ba733..99e4af38e45dd 100644 --- a/docs/framework/wpf/app-development/how-to-detect-whether-the-wpf-plug-in-for-firefox-is-installed.md +++ b/docs/framework/wpf/app-development/how-to-detect-whether-the-wpf-plug-in-for-firefox-is-installed.md @@ -25,7 +25,7 @@ manager: "wpickett" The [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] plug-in for Firefox enables [!INCLUDE[TLA#tla_xbap#plural](../../../../includes/tlasharptla-xbapsharpplural-md.md)] and loose XAML files to run in the Mozilla Firefox browser. This topic provides a script written in HTML and JavaScript that administrators can use to determine whether the WPF plug-in for Firefox is installed. > [!NOTE] -> For more information about installing, deploying, and detecting the [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)], see [Installing the .NET Framework](../../../../docs/framework/install/guide-for-developers.md). +> For more information about installing, deploying, and detecting the [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)], see [Install the .NET Framework for developers](../../../../docs/framework/install/guide-for-developers.md). ## Example When the [!INCLUDE[net_v35_short](../../../../includes/net-v35-short-md.md)] is installed, the client computer is configured with a WPF plug-in for Firefox. The following example script checks for the WPF plug-in for Firefox and then displays an appropriate status message. diff --git a/docs/toc.md b/docs/toc.md index ad890b6ea87c8..22170565ac390 100644 --- a/docs/toc.md +++ b/docs/toc.md @@ -84,6 +84,7 @@ # [.NET Framework Guide](framework/index.md) ## [What's New](framework/whats-new/) ## [Get Started](framework/get-started/) +## [Installation guide](framework/install/) ## [Migration Guide](framework/migration-guide/) ## [.NET Framework on Docker Guide](framework/docker/index.md) ### [Running Console Apps in Containers](framework//docker/console.md) diff --git a/toc.yml b/toc.yml index 2db012a970b6c..59dc550debad1 100644 --- a/toc.yml +++ b/toc.yml @@ -172,17 +172,13 @@ - name: Deploying the .NET Framework tocHref: /dotnet/articles/framework/deployment/ topicHref: /dotnet/articles/framework/deployment/index - items: - - name: Installing the .NET Framework on Windows - tocHref: /dotnet/articles/framework/deployment/windows/ - topicHref: /dotnet/articles/framework/deployment/windows/index - name: Deploying .NET Framework applications with Docker tocHref: /dotnet/articles/framework/docker/ topicHref: /dotnet/articles/framework/docker/index - name: Get Started tocHref: /dotnet/articles/framework/get-started/ topicHref: /dotnet/articles/framework/get-started/index - - name: Installing the .NET Framework on Windows + - name: Installation guide tocHref: /dotnet/articles/framework/install/ topicHref: /dotnet/articles/framework/install/index - name: Interoperating with Unmanaged Code