<runtime> Element

Article
07/23/2022

Provides information used by the common language runtime to configure applications.

Syntax

<runtime>
</runtime>

Attributes and Elements

The following sections describe child elements and parent elements.

Attributes

None.

Child Elements

Element	Description
<alwaysFlowImpersonationPolicy>	Specifies that the Windows identity always flows across asynchronous points, regardless of how impersonation was performed.
<AppContextSwitchOverrides>	Defines one or more switches used by the AppContext class to provide an opt-out mechanism for new functionality.
<appDomainManagerAssembly>	Specifies the assembly that provides the application domain manager for the default application domain in the process.
<appDomainManagerType>	Specifies the type that serves as the application domain manager for the default application domain.
<appDomainResourceMonitoring>	Instructs the runtime to collect statistics on all application domains in the process for the life of the process.
<assemblyBinding>	Contains information about assembly version redirection and the locations of assemblies.
<bypassTrustedAppStrongNames>	Specifies whether strong name verification for trusted assemblies should be bypassed.
<CompatSortNLSVersion>	Specifies that the runtime should use legacy sorting behavior when performing string comparisons.
<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 .NET Framework version 2.0, is disabled.
<disableCommitThreadStack>	Specifies whether the full thread stack is committed when a thread is started.
<disableFusionUpdatesFromADManager>	Specifies whether the default behavior, which is to allow the runtime host to override configuration settings for an application domain, is disabled.
<disableStackOverflowProbing>	Specifies whether stack-overflow probing is disabled.
<EnableAmPmParseAdjustment>	Determines whether date and time parsing methods use an adjusted set of rules to parse date strings that contain only a day, month, hour, and AM/PM designator.
<enforceFIPSPolicy>	Specifies whether to enforce a computer configuration requirement that cryptographic algorithms must comply with the Federal Information Processing Standards (FIPS).
<etwEnable>	Specifies whether to enable event tracing for Windows (ETW) for common language runtime events.
<forcePerformanceCounterUniqueSharedMemoryReads>	Specifies whether PerfCounter.dll uses the CategoryOptions registry setting in a .NET Framework version 1.1 application to determine whether to load performance counter data from category-specific shared memory or global memory.
<gcAllowVeryLargeObjects>	On 64-bit platforms, enables arrays that are greater than 2 gigabytes (GB) in total size.
<gcConcurrent>	Specifies whether the common language runtime runs garbage collection concurrently.
<GCCpuGroup>	Specifies whether garbage collection supports multiple CPU groups.
<GCHeapAffinitizeMask>	Defines the affinity between garbage collection heaps and individual processors.
<GCHeapCount>	Specifies the number of heaps/threads to use for server garbage collection.
<GCLOHThreshold>	Specifies the threshold size that causes the garbage collector to put objects on the large object heap.
<GCConserveMemory>	Configures the garbage collector to conserve memory at the expense of more frequent garbage collections and possibly longer pause times.
<GCNoAffinitize>	Specifies whether or not to affinitize server garbage collection threads with CPUs.
<gcServer>	Specifies whether the common language runtime runs server garbage collection.
<generatePublisherEvidence>	Specifies whether the runtime uses code access security (CAS) publisher policy.
<legacyCorruptedStateExceptionsPolicy>	Specifies whether the runtime allows managed code to catch access violations and other corrupted state exceptions.
<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.
<loadfromRemoteSources>	Specifies whether assemblies from remote sources are loaded as full trust.
<NetFx40_LegacySecurityPolicy>	Specifies whether the runtime uses legacy code access security (CAS) policy.
<NetFx40_PInvokeStackResilience>	Specifies whether the runtime automatically fixes incorrect platform invoke declarations at run time, at the cost of slower transitions between managed and unmanaged code.
<NetFx45_CultureAwareComparerGetHashCode_LongStrings>	Specifies whether the runtime uses a fixed amount of memory to calculate hash codes for the StringComparer.GetHashCode method.
<PreferComInsteadOfRemoting>	Specifies that the runtime will use COM interop instead of remoting across application domain boundaries.
<relativeBindForResources>	Optimizes the probe for satellite assemblies.
<shadowCopyVerifyByTimeStamp>	Specifies whether shadow copying uses the default startup behavior introduced in the .NET Framework 4, or reverts to the startup behavior of earlier versions of the .NET Framework.
<supportPortability>	Specifies that an application can reference the same assembly in two different implementations of the .NET Framework, by disabling the default behavior that treats the assemblies as equivalent for application portability purposes.
<system.runtime.caching>	Provides configuration information for the default in-memory object cache.
<Thread_UseAllCpuGroups>	Specifies whether the runtime distributes managed threads across all CPU groups.
<ThrowUnobservedTaskExceptions>	Specifies whether unhandled task exceptions should terminate a running process.
<TimeSpan_LegacyFormatMode>	Specifies whether the runtime uses legacy formatting for TimeSpan values.
<useLegacyJit>	Determines whether the common language runtime uses the legacy 64-bit JIT compiler for just-in-time compilation.
<UseRandomizedStringHashAlgorithm>	Specifies whether the runtime calculates hash codes for strings on a per application domain basis.
<UseSmallInternalThreadStacks>	Requests that the runtime use explicit stack sizes when it creates certain threads that it uses internally, instead of the default stack size.

Parent Elements

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

Remarks

The child elements in the <runtime> section of a configuration file are used by the common language runtime to configure how an application executes. For example, the <gcServer> element determines whether the garbage collector uses workstation garbage collection or server garbage collection, the <UseRandomizedStringHashAlgorithm> element determines whether the common language runtime calculates hash codes for string on a per-application or a per-application domain basis, and the AppContextSwitchOverrides element allows library users to opt in or opt out of changed functionality provided by a library.

The elements in the <runtime> section are read automatically by the common language runtime at application startup. You can also define the configuration file for a non-default application domain by supplying its name to the AppDomainSetup.ConfigurationFile property; its settings are read automatically when the application domain is loaded. You should rarely, if ever, have a need to directly read the settings in the <runtime> section of your application's configuration file.