.NET Framework deployment guide for developers
This topic provides information for developers who want to install the .NET Framework 4.5, 4.5.1, 4.5.2, the .NET Framework 4.6, 4.6.1, 4.6.2, or the .NET Framework 4.7 or 4.7.1 with their apps.
For download links, see the section Redistributable Packages. You can also download the redistributable packages and language packs from these Microsoft Download Center pages:
The phrase "the .NET Framework 4.5 and its point releases" refers to the .NET Framework 4.5 and all later versions.
The .NET Framework 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, and 4.7.1 are in-place updates to the .NET Framework 4.5, which means they use the same runtime version, but the assembly versions are updated and include new types and members.
The .NET Framework 4.5 and its point releases are built incrementally on the .NET Framework 4. When you install the .NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, or 4.7.1 on a system that has the .NET Framework 4 installed, the version 4 assemblies are replaced with newer versions.
If you are referencing a Microsoft out-of-band package in your app, the assembly will be included in the app package.
You must have administrator privileges to install the .NET Framework 4.5 and its point releases.
The .NET Framework 4.5 is included in Windows 8 and Windows Server 2012, so you don't have to deploy it with your app on those operating systems. Similarly, the .NET Framework 4.5.1 is included in Windows 8.1 and Windows Server 2012 R2. The .NET Framework 4.5.2 isn't included in any operating systems. The .NET Framework 4.6 is included in Windows 10, the .NET Framework 4.6.1 is included in Windows 10 November Update, and the .NET Framework 4.6.2 is included in Windows 10 Anniversary Update. The .NET Framework 4.7 is included in Windows 10 Creators Update, and the .NET Framework 4.7.1 is included in Windows 10 Fall Creators Update. For a full list of hardware and software requirements, see System Requirements.
Starting with the .NET Framework 4.5, your users can view a list of running .NET Framework apps during setup and close them easily. This may help avoid system restarts caused by .NET Framework installations. See Reducing System Restarts.
Uninstalling the .NET Framework 4.5 or one of its point releases also removes pre-existing .NET Framework 4 files. If you want to go back to the .NET Framework 4, you must reinstall it and any updates to it. (See Installing the .NET Framework 4.)
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. For more information about this issue, see Microsoft Security Advisory 2749655.
For information about how a system administrator can deploy the .NET Framework and its system dependencies across a network, see Deployment Guide for Administrators.
Deployment options for your app
When you're ready to publish your app to a web server or other centralized location so that users can install it, you can choose from several deployment methods. Some of these are provided with Visual Studio. The following table lists the deployment options for your app and specifies the .NET Framework redistributable package that supports each option. In addition to these, you can write a custom setup program for your app; for more information, see the section Chaining the .NET Framework Installation to Your App's Setup.
|Deployment strategy for your app||Deployment methods available||.NET Framework redistributable to use|
|Install from the web||- InstallAware
- WiX toolset
- Manual installation
|Install from disc||- InstallAware
- WiX toolset
- Manual installation
|Install from a local area network (for enterprise apps)||- ClickOnce||Either web installer (see ClickOnce for restrictions) or offline installer|
The .NET Framework is available in two redistributable packages: web installer (bootstrapper) and offline installer (stand-alone redistributable). The following table compares the two packages.
* The offline installer is larger because it contains the components for all the target platforms. When you finish running setup, the Windows operating system caches only the installer that was used. If the offline installer is deleted after the installation, the disk space used is the same as that used by the web installer. If the tool you use (for example, InstallAware or InstallShield) to create your app's setup program provides a setup file folder that is removed after installation, the offline installer can be automatically deleted by placing it into the setup folder.
** If you're using the web installer with custom setup, you can use default language settings based on the user's Multilingual User Interface (MUI) setting, or specify another language pack by using the
/LCID option on the command line. See the section Chaining by Using the Default .NET Framework UI for examples.
Four deployment methods are available:
You can set a dependency on the .NET Framework. You can specify the .NET Framework as a prerequisite in your app's installation, using one of these methods:
You can ask your users to install the .NET Framework manually.
You can chain (include) the .NET Framework setup process in your app's setup, and decide how you want to handle the .NET Framework installation experience:
These deployment methods are discussed in detail in the following sections.
Setting a dependency on the .NET Framework
If you use ClickOnce, InstallAware, InstallShield, or WiX to deploy your app, you can add a dependency on the .NET Framework so it can be installed as part of your app.
ClickOnce deployment is available for projects that are created with Visual Basic and Visual C#, but it is not available for Visual C++.
In Visual Studio, to choose ClickOnce deployment and add a dependency on the .NET Framework:
Open the app project you want to publish.
In Solution Explorer, open the shortcut menu for your project, and then choose Properties.
Choose the Publish pane.
Choose the Prerequisites button.
In the Prerequisites dialog box, make sure that the Create setup program to install prerequisite components check box is selected.
In the prerequisites list, locate and select the version of the .NET Framework that you've used to build your project.
Choose an option to specify the source location for the prerequisites, and then choose OK.
If you supply a URL for the .NET Framework download location, you can specify either the Microsoft Download Center site or a site of your own. If you are placing the redistributable package on your own server, it must be the offline installer and not the web installer. You can only link to the web installer on the Microsoft Download Center. The URL can also specify a disc on which your own app is being distributed.
In the Property Pages dialog box, choose OK.
InstallAware builds Windows app (APPX), Windows Installer (MSI), Native Code (EXE), and App-V (Application Virtualization) packages from a single source. Easily include any version of the .NET Framework in your setup, optionally customizing the installation by editing the default scripts. For example, InstallAware pre-installs certificates on Windows 7, without which the .NET Framework 4.7 setup fails. For more information on InstallAware, see the InstallAware for Windows Installer website.
In Visual Studio, to choose InstallShield deployment and add a dependency on the .NET Framework:
On the Visual Studio menu bar, choose File, New, Project.
In the left pane of the New Project dialog box, choose Other Project Types, Setup and Deployment, InstallShield LE.
In the Name box, type a name for your project, and then choose OK.
If you are creating a setup and deployment project for the first time, choose Go to InstallShield or Enable InstallShield Limited Edition to download InstallShield Limited Edition for your version of Microsoft Visual Studio. Restart Visual Studio.
Go to Project Assistant wizard and choose Application Files to add the Project Output. You can configure other project attributes by using this wizard.
Go to Installation Requirements and select the operating systems and the version of the .NET Framework you want to install.
Open the shortcut menu for your setup project and choose Build.
Windows Installer XML (WiX) deployment
The Windows Installer XML (WiX) toolset builds Windows installation packages from XML source code. WiX supports a command-line environment that can be integrated into your build processes to build MSI and MSM setup packages. By using WiX, you can specify the .NET Framework as a prerequisite, or create a chainer to fully control the .NET Framework deployment experience. For more information about WiX, see the Windows Installer XML (WiX) toolset website.
Installing the .NET Framework manually
In some situations, it might be impractical to automatically install the .NET Framework with your app. In that case, you can have users install the .NET Framework themselves. The redistributable package is available in two packages. In your setup process, provide instructions for how users should locate and install the .NET Framework.
Chaining the .NET Framework installation to your app's setup
If you're creating a custom setup program for your app, you can chain (include) the .NET Framework setup process in your app's setup process. Chaining provides two UI options for the .NET Framework installation:
Use the default UI provided by the .NET Framework installer.
Create a custom UI for the .NET Framework installation for consistency with your app's setup program.
Both methods allow you to use either the web installer or the offline installer. Each package has its advantages:
If you use the web installer, the .NET Framework setup process will decide which installation package is required, and download and install only that package from the web.
If you use the offline installer, you can include the complete set of .NET Framework installation packages with your redistribution media so that your users don't have to download any additional files from the web during setup.
Chaining by using the default .NET Framework UI
To silently chain the .NET Framework installation process and let the .NET Framework installer provide the UI, add the following command to your setup program:
<.NET Framework redistributable> /q /norestart /ChainingPackage <PackageName>
For example, if your executable program is Contoso.exe and you want to silently install the .NET Framework 4.5 offline redistributable package, use the command:
dotNetFx45_Full_x86_x64.exe /q /norestart /ChainingPackage Contoso
You can use additional command-line options to customize the installation. For example:
To provide a way for users to close running .NET Framework apps to minimize system restarts, set passive mode and use the
/showrmuioption as follows:
dotNetFx45_Full_x86_x64.exe /norestart /passive /showrmui /ChainingPackage Contoso
This command allows Restart Manager to display a message box that gives users the opportunity to close .NET Framework apps before installing the .NET Framework.
If you're using the web installer, you can use the
/LCIDoption to specify a language pack. For example, to chain the .NET Framework 4.5 web installer to your Contoso setup program and install the Japanese language pack, add the following command to your app's setup process:
dotNetFx45_Full_setup.exe /q /norestart /ChainingPackage Contoso /LCID 1041
If you omit the
/LCIDoption, setup will install the language pack that matches the user's MUI setting.
Different language packs may have different release dates. If the language pack you specify is not available at the download center, setup will install the .NET Framework without the language pack. If the .NET Framework is already installed on the user’s computer, the setup will install only the language pack.
For a complete list of options, see the Command-Line Options section.
For common return codes, see the Return Codes section.
Chaining by Using a Custom UI
If you have a custom setup package, you may want to silently launch and track the .NET Framework setup while showing your own view of the setup progress. If this is the case, make sure that your code covers the following:
Detect whether the correct version of the .NET Framework is already installed on the user’s computer.
In determining whether the correct version of the .NET Framework is already installed, you should check whether your target version or a later version is installed, not whether your target version is installed. In other words, you should evaluate whether the release key you retrieve from the registry is greater than or equal to the release key of your target version, not whether it equals the release key of your target version.
Detect whether the language packs are already installed on the user’s computer.
If you want to control the deployment, silently launch and track the .NET Framework setup process (see How to: Get Progress from the .NET Framework 4.5 Installer).
If you’re deploying the offline installer, chain the language packs separately.
Customize deployment by using command-line options. For example, if you’re chaining the .NET Framework web installer, but you want to override the default language pack, use the
/LCIDoption, as described in the previous section.
Detecting the .NET Framework
The .NET Framework installer writes registry keys when installation is successful. You can test whether the .NET Framework 4.5 or later is installed by checking the
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full folder in the registry for a
DWORD value named
Release. (Note that "NET Framework Setup" doesn't begin with a period.) The existence of this key indicates that the .NET Framework 4.5 or a later version has been installed on that computer. The value of
Release indicates which version of the .NET Framework is installed.
You should check for a value greater than or equal to the release keyword value when attempting to detect whether a specific version is present.
|Version||Value of the Release DWORD|
|.NET Framework 4.7.1 installed on Windows 10 Fall Creators Update||461308|
|.NET Framework 4.7.1 installed on all OS versions other than Windows 10 Fall Creators Update||461310|
|.NET Framework 4.7 installed on Windows 10 Creators Update||460798|
|.NET Framework 4.7 installed on all OS versions other than Windows 10 Creators Update||460805|
|.NET Framework 4.6.2 installed on Windows 10 Anniversary Edition||394802|
|.NET Framework 4.6.2 installed on all OS versions other than Windows 10 Anniversary Edition||394806|
|.NET Framework 4.6.1 installed on Windows 10 November Update||394254|
|.NET Framework 4.6.1 installed on all OS versions other than Windows 10 November Update||394271|
|.NET Framework 4.6 installed on Windows 10||393295|
|.NET Framework 4.6 installed on all OS versions other than Windows 10||393297|
|.NET Framework 4.5.2||379893|
|.NET Framework 4.5.1 installed with Windows 8.1 or Windows Server 2012 R2||378675|
|.NET Framework 4.5.1 installed on Windows 8, Windows 7||378758|
|.NET Framework 4.5||378389|
Detecting the language packs
You can test whether a specific language pack is installed by checking the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\LCID folder in the registry for a DWORD value named
Release. (Note that "NET Framework Setup" doesn't begin with a period.) LCID specifies a locale identifier; see supported languages for a list of these.
For example, to detect whether the full Japanese language pack (LCID=1041) is installed, check for the following values in the registry:
Key: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\1041 Name: Release Type: DWORD
To determine whether the final release version of a language pack is installed for the .NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, or 4.7.1, check the value of the RELEASE key DWORD value described in the previous section, Detecting the .NET Framework.
Chaining the language packs to your app setup
The .NET Framework provides a set of stand-alone language pack executable files that contain localized resources for specific cultures. The language packs are available from the Microsoft Download Center:
The language packs don't contain the .NET Framework components that are required to run an app; you must install the .NET Framework by using the web or offline installer before you install a language pack.
Starting with the .NET Framework 4.5.1, the package names take the form NDP<
version is the version number of the .NET Framework,
number is a Microsoft Knowledge Base article number, and
culture specifies a country/region. An example of one of these packages is
NDP452-KB2901907-x86-x64-AllOS-JPN.exe. Package names are listed in the Redistributable Packages section earlier in this article.
To install a language pack with the .NET Framework offline installer, you must chain it to your app's setup. For example, to deploy the .NET Framework 4.5.1 offline installer with the Japanese language pack, use the following command:
NDP451-KB2858728-x86-x64-AllOS-JPN.exe/q /norestart /ChainingPackage <ProductName>
You do not have to chain the language packs if you use the web installer; setup will install the language pack that matches the user's MUI setting. If you want to install a different language, you can use the
/LCID option to specify a language pack.
For a complete list of command-line options, see the Command-Line Options section.
The following table lists the most common return codes for the .NET Framework redistributable installer. The return codes are the same for all versions of the installer. For links to detailed information, see the next section.
|0||Installation completed successfully.|
|1602||The user canceled installation.|
|1603||A fatal error occurred during installation.|
|1641||A restart is required to complete the installation. This message indicates success.|
|3010||A restart is required to complete the installation. This message indicates success.|
|5100||The user's computer does not meet system requirements.|
Download error codes
See the following content:
Other error codes
See the following content:
Uninstalling the .NET Framework
Starting with Windows 8, you can uninstall the .NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, or 4.7.1 by using Turn Windows features on and off in Control Panel. In older versions of Windows, you can uninstall the .NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, or 4.7.1 by using Add or Remove Programs in Control Panel.
For Windows 7 and earlier operating systems, uninstalling the .NET Framework 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, or 4.7.1 doesn't restore .NET Framework 4.5 files, and uninstalling the .NET Framework 4.5 doesn't restore .NET Framework 4 files. If you want to go back to the older version, you must reinstall it and any updates to it.
The following table lists options that you can include when you chain the .NET Framework 4.5 redistributable to your app's setup.
|/CEIPConsent||Overwrites the default behavior and sends anonymous feedback to Microsoft to improve future deployment experiences. This option can be used only if the setup program prompts for consent and if the user grants permission to send anonymous feedback to Microsoft.|
||Specifies the name of the executable that is doing the chaining. This information is sent to Microsoft as anonymous feedback to help improve future deployment experiences.
If the package name includes spaces, use double quotation marks as delimiters; for example: /chainingpackage "Lucerne Publishing". For an example of a chaining package, see Getting Progress Information from an Installation Package in the MSDN Library.
|Installs the language pack specified by
For the web installer, this option chain-installs the language package from the web. Note: Use this option only with the web installer.
||Specifies the location of the log file. The default is the temporary folder for the process, and the default file name is based on the package. If the file extension is .txt, a text log is produced. If you specify any other extension or no extension, an HTML log is created.|
|/msioptions||Specifies options to be passed for .msi and .msp items; for example:
|/norestart||Prevents the setup program from rebooting automatically. If you use this option, the chaining app has to capture the return code and handle rebooting (see Getting Progress Information from an Installation Package in the MSDN Library).|
|/passive||Sets passive mode. Displays the progress bar to indicate that installation is in progress, but does not display any prompts or error messages to the user. In this mode, when chained by a setup program, the chaining package must handle return codes.|
|/pipe||Creates a communication channel to enable a chaining package to get progress.|
|/promptrestart||Passive mode only, if the setup program requires a restart, it prompts the user. This option requires user interaction if a restart is required.|
|/q||Sets quiet mode.|
|/repair||Triggers the repair functionality.|
|/serialdownload||Forces the installation to happen only after the package has been downloaded.|
|/showfinalerror||Sets passive mode. Displays errors only if the installation is not successful. This option requires user interaction if the installation is not successful.|
|/showrmui||Used only with the /passive option. Displays a message box that prompts users to close .NET Framework apps that are currently running. This message box behaves the same in passive and non-passive mode.|
|/uninstall||Uninstalls the .NET Framework redistributable.|
The following table lists .NET Framework language packs that are available for the .NET Framework 4.5 and its point releases.
|LCID||Language – country/region||Culture|
|1025||Arabic - Saudi Arabia||ar|
|1028||Chinese – Traditional||zh-Hant|
|1031||German – Germany||de|
|1036||French – France||fr|
|1040||Italian – Italy||it|
|1043||Dutch – Netherlands||nl|
|1046||Portuguese – Brazil||pt-BR|
|2052||Chinese – Simplified||zh-Hans|
|2070||Portuguese – Portugal||pt-PT|
|3082||Spanish - Spain (Modern Sort)||es|
Deployment Guide for Administrators
Install the .NET Framework for developers
Troubleshoot blocked .NET Framework installations and uninstallations
Reducing System Restarts During .NET Framework 4.5 Installations
How to: Get Progress from the .NET Framework 4.5 Installer