Share via


<supportedRuntime> 元素

指定此应用程序支持的公共语言运行时版本。 此元素应由用 .NET Framework 1.1 版或更高版本生成的所有应用程序使用。

<configuration>

   <startup>

      <supportedRuntime>

<supportedRuntime version="runtime version" sku="sku id"/>

特性

特性

说明

version

可选特性。

一个字符串值,它指定此应用程序支持的公共语言运行时 (CLR) 版本。 CLR 的前三个版本由“v1.0.3705”、“v1.1.4322”和“v2.0.50727”指定。 从 .NET Framework 4 版 开始,仅主版本号和次版本号是必需的(即“v4.0”而不是“v4.0.30319”)。 建议使用较短字符串。

注意注意
.NET Framework 版本 3.0 和 3.5 使用 CLR 的版本 2.0.50727。

sku

可选特性。

一个字符串值,指定运行该应用程序的 SKU。 有关更多信息,请参见 .NET Framework Client Profile

备注

如果应用程序配置文件中没有 <supportedRuntime> 元素,则使用用于生成该应用程序的运行时版本。

<supportedRuntime> 元素应由使用运行时 1.1 版或更高版本生成的所有应用程序使用。 仅为支持运行时 1.0 版而生成的应用程序必须使用 <requiredRuntime> 元素。

注意注意

如果使用 CorBindToRuntimeByCfg 函数来指定配置文件,则必须使用适用于运行时的所有版本的 <requiredRuntime> 元素。当您使用 CorBindToRuntimeByCfg 时,<supportedRuntime> 元素将被忽略。

如果支持多个运行时版本,则第一个元素应指定优先级最高的运行时版本,而最后一个元素应指定优先级最低的版本。

注意注意

如果您的应用程序使用旧式激活路径,如 CorBindToRuntimeEx function(CorBindToRuntimeEx 功能),并且您希望这些路径激活 CLR 的版本 4(而不是较早的版本),或者如果您的应用程序是用 .NET Framework 4 生成的,但在使用较早版本的 .NET Framework 生成的混合模式程序集上有依赖项,则它不足以在受支持运行时列表中指定 .NET Framework 4。此外,在配置文件的 <startup> 元素中,必须将 useLegacyV2RuntimeActivationPolicy 特性设置为 true。但是,将此属性设置为 true 意味着用 .NET Framework 早期版本生成的所有组件都使用 .NET Framework 4(而不是生成它们时所用的运行时)运行。

示例

下面的示例显示如何在配置文件中指定支持的运行时版本。

<configuration>
   <startup>
      <supportedRuntime version="v1.1.4322"/>
      <supportedRuntime version="v1.0.3705"/>
   </startup>
</configuration>

配置文件

此元素可用于应用程序配置文件中。

请参见

参考

启动设置架构

概念

指定要使用的运行时版本

其他资源

.NET Framework 的配置文件架构

进程内并行执行