Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
SetCompatibilitySwitches Method

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)

'Declaration
Public Sub SetCompatibilitySwitches ( _
	switches As IEnumerable(Of String) _
)

Parameters

switches
Type: System.Collections.Generic.IEnumerable(Of String)

An enumerable set of string values that specify compatibility switches, or Nothing 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 Nothing 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.6, 4.5, 4

.NET Framework Client Profile

Supported in: 4
Show:
© 2015 Microsoft