.NET 框架可重新分发软件包 1.1 版技术参考
Microsoft Corporation
本文档作为 Microsoft Visual Studio .NET 2003、Visual Basic .NET、Visual C++ .NET、Visual C# .NET、Visual J# .NET 和/或 Microsoft .NET 框架 SDK 1.1 版（它们都是“Microsoft 开发人员工具”）的组成部分提供给您，专门供您在分发或内部部署 Microsoft .NET 框架可重新分发文件 (Dotnetfx.exe) 时与之结合使用。
Microsoft 对本文档中的主题持有专利权、专利申请权、商标权、版权或其他相关的知识产权。除非 Microsoft 以任何书面许可协议明确提供，否则向您提供本文档并没给予您使用这些专利、商标、版权或其他知识产权的任何许可证。有关分发或内部部署 Dotnetfx.exe 的信息，请参阅 Microsoft 开发人员工具附带的最终用户许可协议。
2003 Microsoft Corporation 版权所有。保留所有权利。
摘要：针对 .NET 框架 1.1 版编写的应用程序和控件要求在运行该应用程序或控件的计算机上安装 .NET 框架可重新分发程序包 1.1 版。.NET 框架可重新分发程序包是一个独立的可执行文件 Dotnetfx.exe。本文介绍从何处获得 Dotnetfx.exe 以及如何使用它来部署 .NET 框架应用程序。
注：如果选择使用 Dotnetfx.exe 或与您创建的应用程序一起重新分发该程序，您必须具有 Microsoft .NET 框架 SDK 1.1 版（或 Visual Studio?.NET）的一份有效许可，而且使用或分发 Dotnetfx.exe 均需要遵守 Microsoft .NET 框架 SDK 1.1 版（或 Visual Studio?.NET）附带的最终用户许可协议条款。如果没有 Microsoft .NET 框架 SDK 1.1 版（或 Visual Studio?.NET）的有效许可，您就无权使用或分发 Dotnetfx.exe。
本页内容
| 简介 | |
| 从哪里获得 .NET 框架可重新分发版本 1.1 软件包 | |
| Dotnefx.exe 选项和错误 | |
| 安装 Dotnetfx.exe 的本地化版本 | |
| 最低配置要求 |
简介
Microsoft? .NET 框架 1.1 发布版提供了一个可重新分发的安装程序，其中包含运行 .NET 框架应用程序所必需的公共语言运行库和 .NET 框架组件。.NET 框架可重新分发程序包是一个独立的可执行文件 Dotnetfx.exe。.NET 框架需要许可协议来赋予您重新分发 Dotnetfx.exe 的具体权限。如果您以前已经安装了 Microsoft Visual Studio .NET 2003、.NET 框架 SDK 1.1 版或从 Web 下载的 Dotnetfx.exe，则表明您已经接受 Dotnetfx.exe 的许可协议。有关该许可协议的条款，请参阅 .NET 框架 Redistributable EULA。
您可以在计算机上手动启动和安装 Dotnetfx.exe，也可以将其作为 .NET 框架应用程序的安装程序的组成部分来启动和安装。注意，必须要有管理员权限才能安装 Dotnetfx.exe。如果先前已经安装 .NET 框架 SDK 1.1 版或 Microsoft Visual Studio .NET 2003，则不需要安装 Dotnetfx.exe。
该白皮书只提供 Dotnetfx.exe 的技术参考。有关部署 Dotnetfx.exe 的详细信息，请参阅 .NET 框架 1.1 部署指南。该Web 站点提供详细的部署信息，其中包括向 .NET 框架 SDK 1.1 版用户和 Visual Studio .NET 2003 用户介绍具体部署情形的白皮书。
要安装 Dotnetfx.exe，必须满足最低配置要求。有关软件和硬件要求及建议的更多信息，请参阅最低配置要求。
从哪里获得 .NET 框架可重新分发版本 1.1 软件包
可以从 Microsoft Download Center 或从 Microsoft Windows Update Web 站点下载 Dotnetfx.exe。
也可以在产品 CD 或 DVD 上获得可重新分发程序包。Dotnetfx.exe 可从 .NET 框架 SDK 1.1 版 CD 上根目录中的 dotNETRedist 目录获得。它包含在 Microsoft Visual Studio .NET 2003 Prerequisites CD 上的 dotNetFramework 目录中，以及在 Microsoft Visual Studio .NET 2003 DVD 上的 \wcu\dotNetFramework 目录中。
MSDN 上的 .NET 框架 SDK 页包含有关如何订购这些产品的信息。
如果需要让用户从 Internet 安装 .NET 框架，请勿发布 .NET 框架可重新分发软件包 1.1 版，而应该让用户转向 Microsoft Windows Update Web 站点。
Dotnefx.exe 选项和错误
.NET 框架可重新分发软件包 1.1 版使用了一个 Windows Installer 软件包，该软件包将它包装到一个单独的自解压可执行文件 Dotnetfx.exe 中。Dotnetfx.exe 可执行文件会启动 Install.exe，后者将执行平台检查，并根据需要安装 Windows Installer 2.0，然后启动 Windows Installer 软件包（.msi 文件）。
表 1 描述了在安装 Dotnetfx.exe 时可以指定的命令行选项。要在安装 Dotnetfx.exe 时指定选项，必须使用 /c:，选项，将选项传递给 Install.exe 包装程序。
语法
dotnetfx [/q:a] [/c:"Install [/l][/q]"]
| 表 1. 安装 Dotnetfx.exe 时的命令行选项 | |
| 选项 | 说明 |
|
/l |
在 %temp% 目录中创建安装日志 netfx.log。从 Dotnetfx.exe 返回的错误代码将写入该日志。可以在 /l 的后面指定完整路径。 |
|
/q |
指定无提示安装模式。这将不显示安装程序用户界面。对于无提示安装，还必须指定 Dotnetfx.exe /q:a 选项，以便不显示文件解压缩过程用户界面。 |
应当使用 Windows Add/Remove Programs 选项来卸载驻留 Dotnetfx.exe 的 .NET 框架应用程序。这样才能确保 Dotnetfx.exe 不会独立于依赖它才能运行的应用程序而单独卸载。
使用示例
以下命令将安装 Dotnetfx.exe 可重新分发软件包。
dotnetfx /c:"install"
启动 Dotnetfx.exe 和语言包的无提示安装
以下命令启动 Dotnetfx.exe 的无提示安装。
dotnetfx.exe /q:a /c:"install /l /q"
以下命令启动 langpack.exe（任意语言包）的无提示安装。
LangPack.exe /q:a /c:"inst /q"
无提示安装取消显示整个用户界面以及 Dotnetfx.exe 和 Install.exe（包含在 Dotnetfx.exe 中）返回的错误消息。为无提示安装指定 /q:a 和 /q 选项可带来标准化用户安装体验。指定 /l 选项可以在记录所有错误的 %temp% 目录中创建一个安装日志文件 netfx.log。
错误代码
表 2 描述了 Dotnetfx.exe 返回的错误。
| 表 4. Windows Installer 错误 | |
| 错误 | 说明 |
|
1601 |
Windows Installer 服务无法访问。与技术支持人员联系，确认 Windows Installer 服务正确注册。 |
|
1602 |
户取消安装。 用户单击了用户界面上的 Cancel 按钮。安装无法继续。 |
|
1603 |
安装过程中发生致命错误。 安装 Windows Installer 期间出现致命错误。无法继续安装 Dotnetfx.exe。 |
|
1622 |
打开安装日志文件时发生错误。确认指定的日志文件位置存在并且为可写。 在卸载期间，如果没有磁盘空间或启用了 Windows Installer 日志，则很有可能出现该错误。在安装期间，如果没有足够的空间来写入 Windows Installer 日志，或日志是只读的，也可以出现该错误。 |
|
1633 |
此平台不支持本安装包。与应用程序厂商联系。 |
安装 Dotnetfx.exe 的本地化版本
.NET 框架可重新分发程序包 (Dotnetfx.exe) 有 22 种语言版本。所有 Dotnetfx.exe 版本的编程方式都是相同的，22 种版本彼此之间的唯一不同之处是安装过程中显示的用户界面。例如，在采用英语的计算机上安装 Dotnefx.exe 的日语版本时，所有安装对话框和最终用户许可协议 (EULA) 都将使用日语，但代码本身不会被本地化，.NET 框架显示的所有对话框都将使用英语。因此，如果希望看见采用某种特定语言的安装对话框，则应该安装相应的 Dotnetfx.exe 版本。
要使 .NET 框架 1.1 版显示日语对话框，还必须安装相应的语言包。.NET 框架 1.1 版的语言包仅包含本地化资源（例如错误消息），而不会以编程的方式更改 .NET 框架 1.1 版中的任何信息。
.NET 框架 1.1 版可以使用 21 种语言包，而且可以在同一台计算机上安装所有这些语言包。但是，由于默认情况下 Dotnetfx.exe 的所有错误代码和消息都采用英语，所以没有英语语言包。
在各种可能的情况下，都应在本地化计算机上安装 Dotnetfx.exe 的本地化版本和匹配的语言包。也就是说，在日语计算机上安装时，应安装已本地化为日语的 Dotentfx.exe 和日语语言包。
注：在运行 Windows 98 或 Windows Me 操作系统的计算机上安装 .NET 框架语言包时，系统代码页和字体必须支持所安装的语言包。有以下几种选项：
| • |
安装与 Windows 的语言相同的语言包。例如，在 Windows 98 日语版上安装日语语言包。 |
| • |
在 Windows 本地化版本上安装语言包的本地化版本，其中，两种语言的系统代码页是相同的。例如，在 Windows98 德语版上安装法语语言包。 |
| • |
在任何 Windows 本地化版本上安装 .NET 框架 1.1 版。如果系统代码页和字体不支持所安装的 .NET 框架语言包的语言，则对话框将无法正确显示。例如，在 Windows 98 英语版上安装日语语言包时，设置对话框就无法正确显示文字。 |
此限制仅适用于 Windows 98 和 Windows Me 系统。可以在 Windows 2000、Windows NT 4.0、Windows XP 或 Windows Server 2003 系列的任何语言版本上安装任何 .NET 框架语言包。
下表列出了所有可用的语言包。
| 语言 | LCID |
|
中文（简体） |
2052 |
|
中文（繁体） |
1028 |
|
捷克语 |
1029 |
|
丹麦语 |
1030 |
|
荷兰语 |
1043 |
|
芬兰语 |
1035 |
|
法语 |
1036 |
|
德语 |
1031 |
|
希腊语 |
1032 |
|
匈牙利语 |
1038 |
|
意大利语 |
1040 |
|
日语 |
1041 |
|
朝鲜语 |
1042 |
|
挪威语 |
1044 |
|
波兰语 |
1045 |
|
葡萄牙语（巴西） |
1046 |
|
葡萄牙语（葡萄牙） |
2070 |
|
俄语 |
1049 |
|
西班牙语 |
3082 |
|
瑞典语 |
1053 |
|
土耳其语 |
1055 |
