如何：将应用配置为支持 .NET Framework 4 或更高版本

托管公共语言运行时 (CLR) 的所有应用程序都必须启动（或激活）CLR，才能运行托管代码。 通常，.NET Framework 应用在生成它的 CLR 版本上运行，但你可以使用应用程序配置文件（有时称为 app.config 文件）来更改桌面应用程序的此行为。 但是，您不能使用应用程序配置文件来更改 Windows 应用商店应用或 Windows Phone 应用程序的默认激活行为。 本文说明如何使桌面应用程序能够在 .NET Framework 的其他版本上运行，并提供了如何定位版本 4 或更高版本的示例。

按下列顺序确定在其上运行应用程序的 .NET Framework 的版本：

• 配置文件。

  如果应用程序配置文件中的 <supportedRuntime> 条目指定了一个或多个 .NET Framework 版本，且用户的计算机安装的是其中一个版本，那么应用程序就会在相应版本中运行。 配置文件按列出顺序读取 <supportedRuntime> 条目，并使用列出的第一个在用户计算机上安装的 .NET Framework 版本。 （对 1.0 版使用 <requiredRuntime> 元素。）

• 编译的版本。

  如果不存在任何配置文件，但用户计算机上存在基于其构建应用程序的 .NET Framework 版本，则此应用程序将在此版本上运行。

• 已安装的最新版本。

  如果没有生成应用程序时使用的 .NET Framework 版本，且配置文件未在 <supportedRuntime> 元素中指定版本，那么应用程序会尝试在用户计算机上安装的最新版 .NET Framework 中运行。

  但是，.NET Framework 1.0、1.1、2.0、3.0 和 3.5 应用程序不会自动在 .NET Framework 4 或更高版本上运行，在某些情况下，用户可能会收到错误，且系统可能会提示用户安装 .NET Framework 3.5。 由于不同版本的 Windows 系统包含的 .NET Framework 版本不同，因此激活行为还取决于用户的操作系统。 如果应用程序支持 .NET Framework 3.5 和 4 或更高版本，建议您在配置文件中使用多个条目来指明这一点，以避免 .NET Framework 初始化错误。 有关详细信息，请参见版本和依赖关系。

为了利用版本 4 和更高版本中的性能改进，可能还需要将 .NET Framework 3.5 应用配置为在 .NET Framework 版本 4 或更高版本上运行，甚至在安装了 .NET Framework 3.5 的计算机上也是如此。

若要了解如何将 .NET Framework 1.0 和 1.1 应用程序修改为支持 Windows 7 和 Windows 8，请参阅从 .NET Framework 1.1 迁移。

将应用程序配置为在 .NET Framework 4 或更高版本上运行

1. 添加或查找 .NET Framework 项目的配置文件。 应用程序的配置文件与该应用程序位于相同的目录中，并且具有相同的名称，只不过它具有扩展名 .config。 例如，对于名为 MyExecutable.exe 的应用程序，应用程序配置文件的名称为 MyExecutable.exe.config。

   若要添加配置文件，请在 Visual Studio 菜单栏上依次选择“项目”和“添加新项”。 在左侧窗格中，依次选择“常规”和“配置文件”。 将配置文件命名为 App.config。这些菜单选项对于 Windows 应用商店应用或 Windows Phone 应用程序项目不可用，因为无法在这些平台上更改激活策略。

2. 在应用程序配置文件中添加如下 <supportedRuntime> 元素：

   <configuration>
     <startup>
       <supportedRuntime version="version"/>
     </startup>
   </configuration>
   

   其中，<version> 指定与应用程序支持的 .NET Framework 版本匹配的 CLR 版本。 使用以下字符串：

   • .NET Framework 1.0：“v1.0.3705”

   • .NET Framework 1.1：“v1.1.4322”

   • .NET Framework 2.0、3.0 和 3.5：“v2.0.50727”

   • .NET Framework 4 及更高版本：“v4.0”

   可以添加多个 <supportedRuntime> 元素（按优先顺序列出）来指定对多个 .NET Framework 版本的支持。

下表演示安装在计算机上的应用程序配置文件设置和 .NET Framework 版本如何确定在计算机上运行的 .NET Framework 3.5 应用程序的版本。 这些示例特定于 .NET Framework 3.5 应用程序，但您可以将类似逻辑用于使用早期版本的 .NET Framework 生成的目标应用程序。 请注意，.NET Framework 2.0 版本号 (v2.0.50727) 用于在应用程序配置文件中指定 .NET Framework 3.5。

* 若要详细了解此错误消息及其避免方法，请参阅 .NET Framework 初始化错误：管理用户体验。

请参阅

• 从 .NET Framework 1.1 迁移
• 迁移指南