大网数据广告活动
.NET 与 C# 开发

配置元素的.NET

· 52CE 我爱测

如果 元素不存在应用程序配置文件,请使用用于生成应用程序的运行时的版本。

指定的公共语言运行时版本和 (可选) 应用程序的.NET Framework 版本支持。

<configuration>
  <startup>
     <supportedRuntime>

语法

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

特性

特性 描述
版本 可选特性。 一个字符串值,它指定此应用程序支持的公共语言运行时 (CLR) 版本。 有关的有效值version属性,请参阅"运行时版本"值部分。 注意: 通过.NET Framework 3.5"运行时版本"值的形式主要。次要。生成。 从.NET Framework 4 中,仅主版本号和次版本号是必需 (即"v4.0"而不是"v4.0.30319")。 建议使用较短字符串。
sku 可选特性。 一个字符串值,该值指定库存单位 (SKU),库存单位则指定此应用程序支持的 .NET Framework 版本。 从 .NET Framework 4.0 起,建议使用 sku 特性。 若存在该特性,则它指示应用面向的 .NET Framework 版本。 有关有效的 sku 属性的值,请参阅"sku id"值部分。

备注

如果 <supportedRuntime> 元素不存在应用程序配置文件,请使用用于生成应用程序的运行时的版本。

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

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

对于支持从 .NET Framework 1.1 到 3.5 的运行时版本的应用,支持多个运行时版本时,第一个元素应指定优先级最高的版本,最后一个元素应指定优先级最低的版本。 对于支持的.NET Framework 4.0 或更高版本的应用version属性指示的 CLR 版本,这是普遍适用于.NET Framework 4 和更高版本,并且sku属性指示的单个.NET Framework 版本的应用程序的目标。

如果 <supportedRuntime > 具有元素sku属性配置文件中存在且已安装的.NET Framework 版本为较低则指定的受支持的版本,该应用程序无法运行,而是显示一条消息询问要安装受支持的版本。 否则为应用程序尝试任何已安装的版本上运行,但它可能出现意外行为是否不与该版本完全兼容。 (有关兼容性的.NET Framework 版本之间的差异,请参阅.NET Framework 中的应用程序兼容性。)因此,我们建议您在更容易错误诊断的应用程序配置文件中包含此元素。 (已创建新项目时由 Visual Studio 自动生成的配置文件包含它。)

Note: 如果你的应用程序使用旧式激活路径,如CorBindToRuntimeEx 函数,并且希望这些路径来激活而不是早期版本的 CLR 版本 4 或如果你的应用程序使用.NET Framework 生成4,但具有一个依赖项上使用.NET Framework 的早期版本构建的混合模式程序集,它足以不受支持运行时在列表中指定.NET Framework 4。 此外,在<启动 > 元素在配置文件中,必须设置useLegacyV2RuntimeActivationPolicy归于true。 但是,此属性设置为true而不与同时生成的运行时使用.NET Framework 4 运行使用.NET Framework 的早期版本生成的所有组件的方式。

我们建议你使用应用程序可在其上运行的所有 .NET Framework 版本来测试这些应用程序。

“运行时版本”值

runtime属性指定给定应用程序所需的公共语言运行时 (CLR) 版本。 请注意,所有.NET Framework v4.x 版本都指定v4.0CLR。 下表列出了有效值运行时版本的值version属性。

.NET Framework 版本 version 属性
1.0 "v1.0.3705"
1.1 "v1.1.4322"
2.0 "v2.0.50727"
3.0 "v2.0.50727"
3.5 "v2.0.50727"
4.0-4.8 "v4.0"

"sku id"值

sku特性使用目标框架名字对象 (TFM) 以指示应用所面向并运行所需的.NET framework 版本。 下表列出了受支持的有效值sku属性,从.NET Framework 4 开始。

.NET Framework 版本 sku 属性
4.0 ".NETFramework,Version=v4.0"
4.0,客户端配置文件 ".NETFramework,Version=v4.0,Profile=Client"
4.0,平台更新 1 ".NETFramework,Version=v4.0.1"
4.0,客户端配置文件,Update 1 ".NETFramework,Version=v4.0.1,Profile=Client"
4.0,平台更新 2 ".NETFramework,Version=v4.0.2"
4.0,客户端配置文件,Update 2 ".NETFramework,Version=v4.0.2,Profile=Client"
4.0,平台更新 3 ".NETFramework,Version=v4.0.3"
4.0,客户端配置文件,Update 3 ".NETFramework,Version=v4.0.3,Profile=Client"
4.5 ".NETFramework,Version=v4.5"
4.5.1 ".NETFramework,Version=v4.5"
4.5.2 ".NETFramework,Version=v4.5"
4.6 ".NETFramework,Version=v4.5"
4.6.1 ".NETFramework,Version=v4.5"
4.6.2 ".NETFramework,Version=v4.6.2"
4.7 ".NETFramework,Version=v4.7"
4.7.1 ".NETFramework,Version=v4.7.1"
4.7.2 ".NETFramework,版本 = v4.7.2"
4.8 ".NETFramework,Version=v4.8"

示例

下面的示例演示如何在配置文件中指定支持的运行时版本。 配置文件指示应用面向.NET Framework 4.7。

<configuration>
   <startup>
      <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.7" />
   </startup>
</configuration>

配置文件

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

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 04/02/2019
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。