.NET Framework 部署指南（针对开发人员）

项目
05/10/2023

注意

本文特定于 .NET Framework。它不适用于 .NET 的较新版本实现，包括 .NET 6 及更高版本。

本文为想要随自己的应用一起安装任何版本 .NET Framework（从 .NET Framework 4.5 到 .NET Framework 4.8）的开发人员提供了相关信息。

可从下载页面下载针对 .NET Framework 的可再发行组件包和语言包：

重要

为了支持不断更新的行业标准，使用 SHA1 算法证书进行数字签名的 .NET Framework 内容将停用。

以下版本的 .NET Framework 将于 2022 年 4 月 26 日到期：4.5.2、4.6 与 4.6.1。在此日期之后，将不再为这些版本提供安全修补程序、更新和技术支持。

为了继续接收更新和技术支持，如果使用 .NET Framework 4.5.2、4.6 或 4.6.1，请于 2022 年 4 月 26 日前将已部署的运行时更新为更新版本，例如“.NET Framework 4.6.2”。

已更新的 SHA2 签名安装程序可用于 .NET Framework 3.5 SP1 与 4.6.2 至 4.8。有关详细信息，请参阅 SHA1 停用计划、.NET 4.5.2、4.6 与 4.6.1 生命周期更新博客文章以及常见问题解答。

重要说明：

从 .NET Framework 4.5.1 到 .NET Framework 4.8 的 .NET Framework 版本已就地更新到 .NET Framework 4.5，这意味着它们将使用相同的运行时版本，但是程序集版本会更新并且包括新类型和成员。
.NET Framework 4.5 及更高版本以增量方式在 .NET Framework 4上创建。在安装了 .NET Framework 4 的系统上安装 .NET Framework 4.5 或更高版本时，版本 4 程序集将替换为更新版本。
如果你正在应用中引用一个 Microsoft 带外包，则程序集将包括在应用包内。
你必须拥有管理员特权才能安装 .NET Framework 4.5 或更高版本。
Windows 8 和 Windows Server 2012 中已经包括 .NET Framework 4.5，因此你不必在这些操作系统上随你的应用一起部署此组件。同样，Windows 8.1 和 Windows Server 2012 R2 中也已包括 .NET Framework 4.5.1。 .NET Framework 4.5.2 不包含在任何操作系统中。 .NET Framework 4.6 包括在 Windows 10 中，.NET Framework 4.6.1 包括在 Windows 10 11 月更新中，而 .NET Framework 4.6.2 包括在 Windows 10 周年更新中。 .NET Framework 4.7 包含在 Windows 10 创意者更新中，.NET Framework 4.7.1 包含在 Windows 10 Fall Creators Update 中，.NET Framework 4.7.2 包含在 Windows 10 2018 年 10 月更新和 Windows 10 2018 年 4 月更新中。 .NET Framework 4.8 包含在 Windows 10 2019 年 5 月更新以及所有更高版本的 Windows 10 更新中。有关硬件和软件要求的完整列表，请参阅系统要求。
从 .NET Framework 4.5 开始，你的用户可以在安装过程中查看运行中 .NET Framework 应用的列表并轻松关闭这些应用。这可能有助于避免系统因安装 .NET Framework 而重新启动。参见减少系统重新启动。
卸载 .NET Framework 4.5 或更高版本也会删除预先存在的 .NET Framework 4 文件。若要返回到 .NET Framework 4，你必须重新安装它以及它的任何更新。请参阅安装 .NET Framework 4。
.NET Framework 4.5 可再发行组件于 2012 年 10 月 9 日进行了更新，纠正了一个与数字证书中的错误时间戳相关的问题，此问题会导致 Microsoft 生成并签名的文件中的数字签名提前过期。如果之前安装了日期为 2012 年 8 月 16 日的 .NET Framework 4.5 可再发行组件包，建议使用 .NET Framework 下载页内的最新可再发行组件来更新副本。有关此问题的更多信息，请参阅 Microsoft 安全公告 2749655。

有关系统管理员可如何在网络中部署 .NET Framework 及其系统依赖项的信息，请参见阅适用于管理员的部署指南。

应用的部署选项

当准备好将你的应用发布到 Web 服务器或其他集中位置时，以便用户可以安装此应用时，你可以选择多种部署方法。其中一些随 Visual Studio 一起提供。下表列出了你的应用的部署选项，并指定了支持每个选项的 .NET Framework 可再发行组件包。除此之外，你还可以为你的应用编写自定义安装程序；有关更多信息，请参见将 .NET Framework 安装链接到应用的安装程序一节。

你的应用的部署策略	可用的部署方法	要使用的 .NET Framework 可再发行组件
从 Web 安装	- InstallAware - InstallShield - WiX 工具集 - 手动安装	Web installer
从磁盘安装	- InstallAware - InstallShield - WiX 工具集 - 手动安装	Offline installer
从局域网安装（适用于企业应用）	- ClickOnce	Web 安装程序（有关限制，请参见 ClickOnce ）或脱机安装程序

可再发行组件包

.NET framework 通过两种可再发行组件包提供：Web 安装程序（引导程序）和脱机安装程序（独立的可再发行组件）。所有 .NET Framework 下载都托管在下载 .NET Framework 页。下表对两种组件包进行了比较：

	Web 安装程序	脱机安装程序
是否需要 Internet 连接？	是	否
下载文件大小	较小（仅包含面向目标平台的安装程序）*	较大*
语言包	包括**	除非使用面向所有操作系统的程序包，否则必须单独安装
部署方法	支持所有方法： - ClickOnce - InstallAware - InstallShield - Windows Installer XML (WiX) - 手动安装 - 自定义安装（链接）	支持所有方法： - ClickOnce - InstallAware - InstallShield - Windows Installer XML (WiX) - 手动安装 - 自定义安装（链接）

* 因为脱机安装程序包含面向所有目标平台的组件，因此它更大。当运行完安装程序后，Windows 操作系统仅会缓存已用的安装程序。如果安装后删除脱机安装程序，则所使用的磁盘空间与 Web 安装程序使用的空间相同。如果你用来创建应用安装程序的工具（例如，InstallAware 或 InstallShield）提供了一个会在安装后移除的安装文件文件夹，则将脱机安装程序放入此安装文件夹可自动删除该安装程序。

** 如果使用支持自定义安装的 Web 安装程序，则可以使用基于用户的多语言用户界面 (MUI) 的默认语言设置，或使用命令行上的 /LCID 选项指定其他语言包。有关示例，请参见使用默认 .NET Framework UI 进行链接一节。

部署方法

有四种部署方法可用：

可以设置一个对 .NET Framework 的依赖项。使用下列方法之一，你可以将 .NET Framework 指定为应用安装程序中的一个必备组件：
- 使用 ClickOnce 部署（适用于 Visual Studio）
- 创建 InstallAware 项目（为 Visual Studio 用户提供免费版）
- 创建 InstallShield 项目（适用于 Visual Studio）
- 使用 Windows Installer XML (WiX) 工具集
你可以要求用户手动安装 .NET Framework。
你可以在应用的安装程序中链接（包括） .NET Framework 安装过程，并确定要如何处理 .NET Framework 安装体验：
- 使用默认 UI。由 .NET Framework 安装程序提供安装体验。
- 自定义 UI 以提供一种统一安装体验并监视 .NET Framework 的安装进度。

以下各节将详细讨论这些部署方法。

设置一个对 .NET Framework 的依赖项

如果使用 ClickOnce、InstallAware、InstallShield 或 WiX 来部署你的应用，则可以添加一个对 .NET Framework 的依赖项，以便将其作为应用的一部分进行安装。

ClickOnce 部署

ClickOnce 部署适用于使用 Visual Basic 和 Visual C# 创建的项目，但不适用于 Visual C++。

在 Visual Studio 中，若要选择 ClickOnce 部署并添加对 .NET Framework 的依赖项：

打开要发布的应用项目。
在“解决方案资源管理器”中，打开项目的快捷菜单，然后选择 “属性” 。
选择 “发布” 窗格。
选择 “系统必备” 按钮。
在 “系统必备” 对话框中，确保选中 “创建用于安装系统必备组件的安装程序” 复选框。
在必备组件列表中，找到并选择已用于生成项目的 .NET Framework 版本。
选择一个选项以指定必备组件的源位置，然后选择 “确定” 。

如果你提供 .NET Framework 下载位置的 URL，则可以指定 .NET Framework 下载页或你自己的网站。如果要将可再发行组件包放置在自己的服务器上，则它必须为脱机安装程序，而不是 Web 安装程序。你只能链接到 .NET Framework 下载页上的 Web 安装程序。该 URL 还可以指定一个用于分发你的应用的磁盘。
在 “属性页” 对话框中，选择 “确定” 。

InstallAware 部署

InstallAware 从单个源生成 Windows 应用 (APPX)、Windows Installer (MSI)、本机代码 (EXE) 和 APP-V (Application Virtualization) 包。可以通过编辑默认脚本自定义安装，轻松在你的安装程序中包括任何版本的 .NET Framework。例如，InstallAware 会在 Windows 7 上预安装证书，否则 .NET Framework 4.7 安装程序将失败。有关 InstallAware 的详细信息，请参阅面向 Windows Installer 的 InstallAware 网站。

InstallShield 部署

InstallShield 可生成 Windows 应用包（MSIX、APPX）、Windows Installer 包 (MSI) 和本机代码 (EXE) 安装程序。 InstallShield 还提供 Visual Studio 集成。有关详细信息，请访问 InstallShield 网站。

Windows Installer XML (WiX) 部署

Windows Installer XML (WiX) 工具集通过 XML 源代码生成 Windows 安装包。 WiX 支持一种命令行环境，可以将其集成到你的生成过程中，以便生成 MSI 和 MSM 安装包。通过使用 WiX，你可以将 .NET Framework 指定为系统必备组件，或创建链接器来完全控制 .NET Framework 的部署体验。有关 WiX 的更多信息，请参阅 Windows Installer XML (WiX) 工具集。

手动安装 .NET Framework

在某些情况下，随你的应用一起自动安装 .NET Framework 可能不切实际。此时，可以让用户自行安装 .NET Framework。可再发行组件包通过两个包提供。在安装过程中，请向用户提供有关如何查找并安装 .NET Framework 的说明。

将 .NET Framework 安装链接到应用的安装程序

如果要为你的应用创建自定义安装程序，则可以在应用的安装过程中链接（包括）.NET Framework 安装过程。链接提供了两种 .NET Framework 安装 UI 选项：

使用由 .NET Framework 安装程序提供的默认 UI。
为 .NET Framework 安装创建自定义 UI，与你的应用安装程序保持一致。

这两种方法都允许使用 Web 安装程序或脱机安装程序。每个包都具有自己的优点：

如果使用 Web 安装程序，则 .NET Framework 安装过程将确定所需的安装包，然后从 Web 仅下载并安装该包。
如果使用脱机安装程序，则你可以在再发行介质中包括一套完整的 .NET Framework 安装包，以便用户在 Web 安装过程中不需要从 Web 下载任何其他文件。

使用默认 .NET Framework UI 进行链接

若要静默链接 .NET Framework 安装过程并由 .NET Framework 安装程序来提供 UI，请将下列命令添加到你的安装程序：

<.NET Framework redistributable> /q /norestart /ChainingPackage <PackageName>

例如，如果你的可执行程序是 Contoso.exe 并且希望静默安装 .NET Framework 4.5 脱机可再发行组件包，请使用以下命令：

dotNetFx45_Full_x86_x64.exe /q /norestart /ChainingPackage Contoso

你可以使用其他命令行选项来自定义安装。例如：

若要为用户提供一种方法来关闭运行中的 .NET Framework 应用，从而最大程度减少系统重新启动，请按照如下方式设置被动模式并使用 /showrmui 选项：

dotNetFx45_Full_x86_x64.exe /norestart /passive /showrmui /ChainingPackage Contoso

此命令允许重新启动管理器显示一个消息框，用户可以在安装 .NET Framework 之前关闭 .NET Framework 应用。
如果使用 Web 安装程序，则可以使用 /LCID 选项来指定语言包。例如，若要将 .NET Framework 4.5 Web 安装程序链接到 Contoso 安装程序并安装日语语言包，请将下列命令添加到应用的安装过程：

dotNetFx45_Full_setup.exe /q /norestart /ChainingPackage Contoso /LCID 1041

如果省略 /LCID 选项，则安装程序将安装与用户的 MUI 设置匹配的语言包。

备注

不同的语言包可能具有不同的发布日期。如果下载中心不提供你所指定的语言包，则安装程序将安装不带语言包的 .NET Framework。如果用户计算机中已安装 .NET Framework，则安装程序将仅安装语言包。

有关选项的完整列表，请参见命名行选项一节。

有关常见的返回代码，请参见返回代码一节。

使用自定义 UI 进行链接

如果具有自定义安装包，你可能希望静默启动和跟踪 .NET Framework 安装过程，同时显示自己的安装进度视图。这种情况下，请确保你的代码涵盖以下操作：

检查 .NET Framework 硬件和软件要求。
检测用户计算机中是否已安装 .NET Framework 的正确版本。

重要

确定是否安装了 .NET Framework 的正确版本时，应检查安装的是目标版本还是更高版本，而不是确定是否安装了目标版本。换而言之，应检查从注册表中检索的版本密钥是否大于或等于目标版本的版本密钥，而不是检查其是否等于目标版本的版本密钥。
检测用户计算机中是否已安装语言包。
如果要控制部署，则静默启动并跟踪 .NET Framework 安装过程（请参阅如何：获取 .NET Framework 4.5 安装程序的进度。
如果要部署脱机安装程序，则单独链接语言包。
使用命令行选项自定义部署。例如，如果要链接 .NET Framework Web 安装程序，但是想重写默认语言包，请使用 /LCID 选项（如上一节中所述）。
疑难解答。

检测 .NET Framework

.NET Framework 安装程序会在安装成功时写入一些注册表项。通过在注册表中检查 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full 文件夹中名为 Release 的值 DWORD，可以测试是否安装了 .NET Framework 4.5 或更高版本。（请注意，“NET Framework Setup”不以句点开头。）存在此项即表明计算机中已安装 .NET Framework 4.5 或更高版本。 Release 的值用于指示已安装的 .NET Framework 版本。

重要

当尝试检测是否存在特定版本时，检查是否存在大于或等于版本关键字值的值。

Version	Release DWORD 的值
.NET Framework 4.8.1	533325
安装在 Windows 10 2020 年 5 月更新和 Windows 10 2020 年 10 月更新上的 .NET Framework 4.8	528372
安装在 Windows 10 2019 年 5 月更新和 Windows 10 2019 年 11 月更新上的 .NET Framework 4.8	528040
在除列出的 Windows 10 更新版本之外的所有 OS 版本上安装的 .NET Framework 4.8	528049
安装在 Windows 10 2018 年 4 月更新和 Windows Server 版本 1803 上的 .NET Framework 4.7.2	461808
.NET Framework 4.7.2，安装在除 Windows 10 2018 年 4 月更新和 Windows Server 版本 1803 之外的所有 OS 版本上。这包括 Windows 10 2018 年 10 月更新。	461814
安装在 Windows 10 秋季创意者更新和 Windows Server 版本 1709 上的 .NET Framework 4.7.1	461308
安装在除 Windows 10 秋季创意者更新和 Windows Server 版本 1709 之外的所有 OS 版本上的 .NET Framework 4.7.1	461310
在 Windows 10 创意者更新上安装的 .NET Framework 4.7	460798
在除 Windows 10 创意者更新之外的所有操作系统版本上安装的 .NET Framework 4.7	460805
在 Windows 10 周年纪念版和 Windows Server 2016 上安装的 .NET Framework 4.6.2	394802
在除 Windows 10 周年纪念版和 Windows Server 2016 以外的所有操作系统版本上安装的 .NET Framework 4.6.2	394806
在 Windows 10 11 月更新上安装的 .NET Framework 4.6.1	394254
在除 Windows 10 11 月更新外的所有操作系统版本上安装的 .NET Framework 4.6.1	394271
在 Windows 10 上安装的 .NET Framework 4.6	393295
在除 Windows 10 之外的所有操作系统版本上安装的 .NET Framework 4.6	393297
.NET Framework 4.5.2	379893
使用 Windows 8.1 或 Windows Server 2012 R2 安装的 .NET Framework 4.5.1	378675
在 Windows 8 和 Windows 7 上安装的 .NET Framework 4.5.1	378758
.NET Framework 4.5	378389

检测语言包

你可以测试是否已安装特定语言包，方法是在注册表的 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\LCID文件夹内查找名为 Release 的 DWORD 值。（请注意，“NET Framework Setup”不以句点开头。）LCID 指定一个区域设置标识符；有关这些标识符的列表，请参阅支持的语言。

例如，若要检测是否安装了完整的日语语言包 (LCID=1041)，请在注册表中检索以下命名值：

	值
键	HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\1041
项	发布
类型	DWORD

若要确定是否已安装 .NET Framework 4.5 到 4.7.2 之间的某个特定版本的最终版本语言包，请按照前一部分检测 .NET Framework 中所述检查 RELEASE 项 DWORD 值的值。

将语言包链接到应用安装程序

.NET Framework 提供了一组独立的语言包可执行文件，其中包含适用于特定区域性的本地化资源。这些语言包可以从 .NET Framework 下载页获得：

重要

语言包不包含运行应用所需的 .NET Framework 组件。在安装语言包之前，必须使用 Web 或脱机安装程序安装 .NET Framework。

从 .NET Framework 4.5.1 开始，包名称采用 NDP<version>-KB<number>-x86-x64-AllOS-<culture>.exe 形式，其中 version 是 .NET Framework 的版本号，number 是 Microsoft 知识库文章编号，culture 则指定国家/地区。例如， NDP452-KB2901907-x86-x64-AllOS-JPN.exe就是其中一个安装包。包名称详见本文前面的 Redistributable Packages 一节。

若要随 .NET framework 脱机安装程序一起安装语言包，你必须将其链接到应用的安装程序。例如，若要部署带有日语语言包的.NET Framework 4.5.1 脱机安装程序，请使用下列命令：

NDP451-KB2858728-x86-x64-AllOS-JPN.exe /q /norestart /ChainingPackage <ProductName>

如果使用 Web 安装程序，则不必链接语言包；安装程序将安装与用户的 MUI 设置匹配的语言包。如果要安装其他语言，则可以使用 /LCID 选项指定语言包。

有关命名行选项的完整列表，请参见命名行选项一节。

疑难解答

返回代码

下表列出了 .NET Framework 可再发行安装程序的常见返回代码。所有版本的安装程序的返回代码都是相同的。有关详细信息的链接，请参见下一节。

返回代码	说明
0	已成功完成安装。
1602	用户已取消安装。
1603	安装期间发生错误。
1641	需要重新启动才能完成安装。此消息指示安装成功。
3010	需要重新启动才能完成安装。此消息指示安装成功。
5100	用户计算机不满足系统要求。

下载错误代码

查看以下内容：

其他错误代码