<requiredRuntime> Element

<requiredRuntime> Element

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework General Reference

<requiredRuntime> Element

Specifies that the application supports only version 1.0 of the common language runtime.

<configuration> Element
<startup> Element
<requiredRuntime> Element

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

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute	Description
version	Optional attribute. A String value that specifies the version of the .NET Framework that this application supports. The string value must match the directory name found under the .NET Framework installation root. The contents of the string value are not parsed.
safemode	Optional attribute. Specifies whether the runtime startup code searches the registry to determine the runtime version.

Attribute

Description

version

Optional attribute.

A String value that specifies the version of the .NET Framework that this application supports. The string value must match the directory name found under the .NET Framework installation root. The contents of the string value are not parsed.

safemode

Optional attribute.

Specifies whether the runtime startup code searches the registry to determine the runtime version.

Safemode Attribute

Value	Description
false	Looks in the registry. This is the default value.
true	Does not look in the registry.

Child Elements

None.

Parent Elements

Element	Description
configuration	The root element in every configuration file used by the common language runtime and .NET Framework applications.
startup	Contains the requiredRuntime element.

Remarks

The <supportedRuntime> element should be used by all applications built using version 1.1 or later of the runtime. Applications built to support only version 1.0 of the runtime must use the <requiredRuntime> element.

The version attribute string must match the installation folder name for the specified version of the .NET Framework. This string is not interpreted. If the runtime startup code does not find a matching folder, the runtime is not loaded; the startup code shows an error message and quits.

Note:
The startup code for an application hosted in Microsoft Internet Explorer ignores the <requiredRuntime> element.

Example

The following example shows how to specify the runtime version in a configuration file.

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

Attributes

Safemode Attribute

Child Elements

Parent Elements

Concepts

Reference

Other Resources