AppDomainSetup.SetCompatibilitySwitches Method

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

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


Public Sub SetCompatibilitySwitches ( _
    switches As IEnumerable(Of String) _
public void SetCompatibilitySwitches(
    IEnumerable<string> switches


  • switches
    Type: System.Collections.Generic.IEnumerable<String>
    An enumerable set of string values that specify compatibility switches, or nulla null reference (Nothing in Visual Basic) to erase the existing compatibility switches.


Major versions of the .NET Framework sometimes introduce breaking changes from the previous version. For example, Silverlight 4 introduces a small number of breaking changes from Silverlight 3. 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.

Each time you call this method, it replaces the existing switch settings. To erase the settings, specify nulla null reference (Nothing in Visual Basic) 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.




Restores the behavior of selected Char and String methods that use ordinal string comparison and case conversion with the invariant culture in Silverlight 2 and Silverlight 3.

Version Information


Supported in: 5, 4


For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.