指定的公共语言运行时版本和 (可选) 应用程序的.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,规范化链接,移除外部媒体和导航标记。
