<requiredRuntime> 元素

指定应用程序仅支持公共语言运行时版本 1.0。 此元素已弃用,不应再使用。 supportedRuntime应改用元素。

<配置><启动><requiredRuntime>

Syntax

   <requiredRuntime
version="runtime version"
safemode="true|false"/>

属性和元素

下列各节描述了特性、子元素和父元素。

特性

Attribute Description
version 可选属性。

一个字符串值,该值指定此应用程序支持的 .NET Framework 版本。 字符串值必须与 .NET Framework 安装根目录下找到的目录名称匹配。 不会分析字符串值的内容。
safemode 可选属性。

指定运行时启动代码是否搜索注册表以确定运行时版本。

safemode 属性

价值 Description
false 运行时启动代码在注册表中查找。 这是默认值。
true 运行时启动代码不在注册表中查找。

子元素

没有。

父元素

元素 Description
configuration 公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。
startup 包含 <requiredRuntime> 元素。

注解

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

注释

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

属性 version 字符串必须与指定版本的 .NET Framework 的安装文件夹名称匹配。 不解释此字符串。 如果运行时启动代码找不到匹配的文件夹,则不会加载运行时;启动代码显示错误消息并退出。

Example

以下示例演示如何在配置文件中指定运行时版本。

<configuration>
   <startup>
      <requiredRuntime version="v1.0.3705" safemode="true"/>
   </startup>
</configuration>

另请参阅