<requiredRuntime> 元素
指定应用程序仅支持 1.0 版本的公共语言运行时。 此元素已弃用,不应再使用。 应改用 supportedRuntime
元素。
configuration
<startup>
<requiredRuntime>
语法
<requiredRuntime
version="runtime version"
safemode="true|false"/>
特性和元素
下列各节描述了特性、子元素和父元素。
特性
属性 | 描述 |
---|---|
version |
可选特性。 一个字符串值,它指定此应用程序支持的 .NET Framework 版本。 字符串值必须与 .NET Framework 安装根下的目录名称匹配。 不分析字符串值的内容。 |
safemode |
可选特性。 指定运行时启动代码是否搜索注册表以确定运行时版本。 |
safemode 属性
值 | 说明 |
---|---|
false |
运行时启动代码在注册表中查找。 这是默认值。 |
true |
运行时启动代码无法在注册表中查找。 |
子元素
无。
父元素
元素 | 说明 |
---|---|
configuration |
公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。 |
startup |
包含 <requiredRuntime> 元素。 |
注解
仅为支持运行时 1.0 版而生成的应用程序必须使用 <requiredRuntime>
元素。 使用运行时 1.1 或更高版本生成的应用程序必须使用 <supportedRuntime>
元素。
注意
如果使用 CorBindToRuntimeByCfg 函数来指定配置文件,则必须使用适用于所有运行时版本的 <requiredRuntime>
元素。 当你使用 CorBindToRuntimeByCfg 时,<supportedRuntime>
元素将被忽略。
version
属性字符串必须与 .NET Framework 的指定版本的安装文件夹名称匹配。 不解释此字符串。 如果运行时启动代码找不到匹配的文件夹,则不加载运行时;启动代码将显示一条错误消息并退出。
示例
下面的示例演示如何在配置文件中指定支持的运行时版本。
<configuration>
<startup>
<requiredRuntime version="v1.0.3705" safemode="true"/>
</startup>
</configuration>