通过

如何：配置 .NET Framework 4 运行时

本主题说明如何在不重新编译 .NET Framework 应用程序的情况下，将该应用程序配置为在 .NET Framework 4 版 上运行。

在 .NET Framework 4 上运行应用程序

  1. 在包含应用程序的 .exe 文件的文件夹中，创建包含以下元素的应用程序配置文件：

    <configuration>
   <startup>
      <supportedRuntime version="v4.0"/>
   </startup>
</configuration>

    有关这些元素的更多信息，请参见 <startup> 元素和 <supportedRuntime> 元素。

  2. 运行应用程序。

在 .NET Framework 4 上运行外接程序

  1. 在包含外接程序的 .exe 文件的文件夹中，创建包含以下元素的 XML 文件：

    <configuration>
   <startup useLegacyV2RuntimeActivationPolicy="true">
      <supportedRuntime version="v4.0"/>
   </startup>
</configuration>

    <startup> 元素 的 useLegacyV2RuntimeActivationPolicy 特性必须设置为 true。

  2. 启动应用程序，然后运行外接程序。

在 .NET Framework 4 上运行 Web 应用程序

  1. 在运行用于构建 Web 应用程序的早期版本的 .NET Framework 的计算机上预编译该应用程序。 可以通过使用以下语法运行 ASP.NET 编译工具（位于 [%WinDir%]\Microsoft.Net\Framework\[.NET Framework Version]\ 目录中）来执行此操作：

    aspnet_compiler -v /[ApplicationName] [Destination Directory]

    例如，若要预编译名为 ExampleWebApp 的 Web 应用程序并将生成的程序集放置到 C:\WebApps 目录中，请使用以下命令：

    aspnet_compiler -v /ExampleWebApp c:\WebApps

    有关此过程的更多信息，请参见如何：预编译 ASP.NET 网站项目。

  2. 将已编译的网站程序集复制到已安装 .NET Framework 4 的计算机上。

    注意注意

    还可以在已安装 .NET Framework 4 的计算机上安装面向早期版本的 .NET Framework 的 Web 应用程序。

  3. 验证是否已安装并启用 .NET Framework 4。 在 .NET Framework 4 目录中使用以下命令运行 ASP.NET IIS 注册工具：

    aspnet_regiis –i –enable

    有关此工具的更多信息，请参见 ASP.NET IIS 注册工具 (Aspnet_regiis.exe)。

  4. 验证应用程序池是否面向 .NET Framework 4。

    Web 应用程序现已配置为在 .NET Framework 4 上运行。

在 .NET Framework 4 上运行 ClickOnce 应用程序

  1. 将 compatibleFrameworks 元素添加到 ClickOnce 应用程序的部署清单：

    <compatibleFrameworks xmlns="urn:schemas-microsoft-com:clickonce.v2"> 
  <framework profile="Full" targetVersion="4.0" 
      supportedRuntime="4.0.0" />
</compatibleFrameworks>

    如果希望应用程序运行 .NET Framework 4 Client Profile，请使用以下配置：

    <compatibleFrameworks xmlns="urn:schemas-microsoft-com:clickonce.v2"> 
  <framework profile="Client" targetVersion="4.0" 
      supportedRuntime="4.0.0" />
</compatibleFrameworks>

    有关 ClickOnce 部署的更多信息，请参见 <compatibleFrameworks> 元素（ClickOnce 部署）。

  2. 将应用程序的配置文件更新为包含 supportedRuntime 元素：

    <configuration>
   <startup>
      <supportedRuntime version="v4.0"/>
   </startup>
</configuration>

  3. 将应用程序清单中的现有文件引用更新为包含配置文件：

    <file name="[application file name].exe.config" size="[config file size]">

  4. 使用清单生成和编辑工具 (Mage.exe) 更新应用程序清单中的哈希：

    Mage –update [path to application manifest]

    有关此命令的更多信息，请参见 Mage.exe（清单生成和编辑工具）。

  5. 为更新的应用程序清单签名：

    Mage –Sign [path to application manifest] –CertFile [path to .pfx file]

  6. 更新该部署清单：

    Mage –update [path to deployment manifest] –AppManifest [path to application manifest]

  7. 为更新的部署清单签名：

    Mage –Sign [path to deployment manifest] –CertFile [path to .pfx file]

    ClickOnce 应用程序现已配置为在 .NET Framework 4 上运行。

请参见

其他资源

.NET Framework 4 的迁移指南