RuntimeCompatibilityOptions.DisabledChanges Property

Reference

Definition

Namespace:: Microsoft.Windows.ApplicationModel.WindowsAppRuntime

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

Gets or sets an optional list of specific servicing changes to disable.

The Latest stable channel release notes for the Windows App SDK lists the name of each change that you can disabled.

public:
 property IVector<RuntimeCompatibilityChange> ^ DisabledChanges { IVector<RuntimeCompatibilityChange> ^ get(); };

IVector<RuntimeCompatibilityChange> DisabledChanges();

public IList<RuntimeCompatibilityChange> DisabledChanges { get; }

var iVector = runtimeCompatibilityOptions.disabledChanges;

Public ReadOnly Property DisabledChanges As IList(Of RuntimeCompatibilityChange)

Property Value

IVector<RuntimeCompatibilityChange>

IList<RuntimeCompatibilityChange>

An optional list of specific servicing changes to disable.

Remarks

If you encounter a problem with a specific change in a servicing update, then you can disable just that change by adding it to the DisabledChanges ` list before calling Apply, or by specifying it in your app's project file:

<PropertyGroup>
  <WindowsAppSDKDisabledChanges>SampleApiCrashFix, OtherSampleApiCrashFix</WindowsAppSDKDisabledChanges>
</PropertyGroup>

Note

Disabling a change is a temporary measure, which gives time for a fix to be released in a future Windows App SDK update, or for you to implement an update in your app. You should report any change you disable if you believe it to be a bug in the Windows App SDK. Doing so will help the Windows App SDK team to understand the impact of the change, and prioritize a fix. You can report issues on the WindowsAppSDK GitHub repo.

The capability to disable a change is not available across new Windows App SDK stable releases (such as 1.7.x to 1.8.x), so this doesn't allow you to permanently disable an intentional behavior change. Also, new stable releases, such as 1.8.0, start with no changes available to disable—this capability applies only to disabling targeted servicing changes added in servicing releases.

Applies to