Export (0) Print
Expand All

AppDomainSetup.SetCompatibilitySwitches Method

Sets the specified switches, making the application domain compatible with previous versions of the .NET Framework for the specified issues.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

public void SetCompatibilitySwitches(
	IEnumerable<string> switches
)

Parameters

switches
Type: System.Collections.Generic.IEnumerable<String>

An enumerable set of string values that specify compatibility switches, or null to erase the existing compatibility switches.

Major versions of the .NET Framework sometimes introduce breaking changes from the previous version. For example, the .NET Framework 4 introduces a small number of breaking changes from the .NET Framework 3.5. Use the SetCompatibilitySwitches method to specify that one or more of these breaking changes should be rolled back for the application domain, to make the behavior compatible with the previous version of the .NET Framework.

Each time you call this method, it replaces the existing switch settings. To erase the settings, specify null for the switches parameter.

The set of string values you provide for switches can be a simple string array, because arrays implement the IEnumerable interface.

The following table provides examples of compatibility switches that can be set to restore the behavior of earlier versions of the .NET Framework.

Switch

Meaning

"NetFx40_LegacySecurityPolicy"

Code access security (CAS) for the .NET Framework 3.5 is enabled in this application domain. See <NetFx40_LegacySecurityPolicy> Element.

"NetFx40_Legacy20SortingBehavior"

String sorting defaults for the .NET Framework 3.5 are enabled in this application domain. Successfully restoring legacy sorting behavior also requires the sort00001000.dll dynamic link library to be available on the local system.

"NetFx40_Legacy40SortingBehavior"

String sorting defaults for the .NET Framework 4 and Unicode 5.0 are enabled in this application domain. Successfully restoring legacy sorting behavior also requires the sort00060101.dll dynamic link library to be available on the local system.

"NetFx40_TimeSpanLegacyFormatMode"

TimeSpan formatting behavior for the .NET Framework 3.5 is enabled in this application domain.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4

.NET Framework Client Profile

Supported in: 4

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft