Share via


<runtime> Element 

Contains information about assembly binding and garbage collection.

<runtime>
</runtime>

Attributes and Elements

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

Attributes

None.

Child Elements

Element Description

<alwaysFlowImpersonationPolicy>

Contains information about assembly version redirection and the locations of assemblies.

<assemblyBinding> Element for <runtime>

Contains information about assembly version redirection and the locations of assemblies.

<developmentMode>

Specifies whether the runtime searches for assemblies in directories specified by the DEVPATH environment variable.

<disableCachingBindingFailures>

Specifies whether the caching of binding failures, which is the default behavior in the .NET Framework version 2.0, is disabled.

<gcConcurrent>

Specifies whether the common language runtime runs garbage collection concurrently.

<gcServer>

Specifies whether the common language runtime runs server garbage collection.

<legacyImpersonationPolicy>

Specifies that the Windows identity does not flow across asynchronous points, regardless of the flow settings for the execution context on the current thread.

<legacyV1CASPolicy>

Specifies whether the runtime uses legacy code access security (CAS) policy.

Parent Elements

Element Description

configuration

The root element in every configuration file used by the common language runtime and .NET Framework applications.

Remarks

In the .NET Framework version 2.0, the impersonated identity flows across asynchronous points within an application domain. In the .NET Framework version 2.0, you can enable or disable the flow of impersonation across asynchronous points by properly configuring the runtime element in the machine.config file or in the application configuration file. For ASP.NET, the impersonation flow can be configured in the aspnet.config file found in the <Windows Folder>\Microsoft.NET\Framework\vx.x.xxxx directory.

By default ASP.NET disables the impersonation flow in aspnet.config file by using the following configuration settings:

configuration>
   <runtime>
      <legacyImpersonationPolicy enabled="true"/>
      <alwaysFlowImpersonationPolicy enabled="false"/>
   </runtime>
</configuration>

In ASP.NET, if you want to allow the flow of impersonation instead, you must explicitly use the following configuration settings:

<configuration>
   <runtime>
      <legacyImpersonationPolicy enabled="false"/>
      <alwaysFlowImpersonationPolicy enabled="true"/>
   </runtime>
</configuration>

For more information, see <legacyImpersonationPolicy> Element and <alwaysFlowImpersonationPolicy> Element.

Example

The following example shows how to redirect one assembly version to another.

<configuration>
   <runtime>
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
         <dependentAssembly>
            <assemblyIdentity name="myAssembly"
                              publicKeyToken="32ab4ba45e0a69a1"
                              culture="neutral" />
             <bindingRedirect oldVersion="1.0.0.0"
                              newVersion="2.0.0.0"/>
         </dependentAssembly>
      </assemblyBinding>
   </runtime>
</configuration>

See Also

Tasks

How to: Disable Concurrent Garbage Collection

Reference

Runtime Settings Schema

Concepts

Redirecting Assembly Versions

Other Resources

Configuration File Schema for the .NET Framework