<requiredRuntime> 元素

指定应用程序仅支持公共语言运行时 1.0 版。

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

特性和元素

以下几节描述了属性、子元素和父元素。

特性

特性	说明
version	可选特性。 一个字符串值，它指定此应用程序支持的 .NET Framework 版本。 字符串值必须与位于 .NET Framework 安装根目录下的目录名称匹配。 不分析字符串值的内容。
safemode	可选特性。 指定运行时启动代码是否搜索注册表以确定运行时版本。

安全模式特性

值	说明
false	运行时启动代码在注册表中搜索。 这是默认值。
true	运行时启动代码不在注册表中搜索。

子元素

无。

父元素

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

备注

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

注意
如果使用 CorBindToRuntimeByCfg 函数来指定配置文件，则必须使用适用于运行时的所有版本的 <requiredRuntime> 元素。当您使用 CorBindToRuntimeByCfg 时，<supportedRuntime> 元素将被忽略。

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

注意
Microsoft Internet Explorer 中承载的应用程序的启动代码忽略 <requiredRuntime> 元素。

示例

下面的示例说明如何在配置文件中指定运行时版本。

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

请参见

参考

启动设置架构

概念

指定要使用的运行时版本

其他资源

.NET Framework 的配置文件架构