<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>

另请参阅