<supportedRuntime> Element

  • Article

Specifies which versions of the common language runtime the application supports. This element should be used by all applications built with version 1.1 or later of the .NET Framework.

<configuration>

   <startup>

      <supportedRuntime>

<supportedRuntime version="runtime version"/>

Optional Attributes

Attribute

Description

version

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.

sku

A string value that specifies the SKU that runs the application. For more information, see .NET Framework Client Profile.

Remarks

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 <supportedRuntime> element is not present in the application configuration file, the version of the runtime used to build the application is used.

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.

Note

If you use the CorBindToRuntimeByCfg function to specify the configuration file, you must use the <requiredRuntime> element for all versions of the runtime. The <supportedRuntime> element is ignored when you use CorBindToRuntimeByCfg.

When multiple versions of the runtime are supported, the first element should specify the most preferred version of the runtime, and the last element should specify the least preferred version.

Example

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

<configuration>
   <startup>
      <supportedRuntime version="v1.1.4322"/>
      <supportedRuntime version="v1.0.3705"/>
   </startup>
</configuration>

Configuration File

This element can be used in the application configuration file.

See Also

Concepts

Specifying Which Runtime Version to Use

Reference

Startup Settings Schema

Other Resources

Configuration File Schema for the .NET Framework

Change History

Date

History

Reason

September 2009

Added workaround when using CorBindToRuntimeByCfg.

Content bug fix.