DebugSettings クラス

  • リファレンス

定義

名前空間:
Microsoft.UI.Xaml
編集

デバッグ環境でアプリを実行するときのアプリの特定の側面の動作を宣言します

public ref class DebugSettings sealed
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DebugSettings final
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DebugSettings
Public NotInheritable Class DebugSettings
継承
Object Platform::Object IInspectable DebugSettings
属性
ContractVersionAttribute MarshalingBehaviorAttribute

例

この例では、Application.DebugSettings にアクセスし、シングルトン DebugSettings 値の 2 つのプロパティを にtrue設定する OnLaunched オーバーライドを示します。 このコードのコンテキストは app.xaml 分離コードであるため this 、アプリ用に作成された Application オブジェクトを参照します。

protected override void OnLaunched(LaunchActivatedEventArgs args) {
    this.DebugSettings.EnableFrameRateCounter = true;
    this.DebugSettings.IsOverdrawHeatMapEnabled = true;
    //...
}

注釈

このクラスは構築できません。 Application.DebugSettings から値を取得し、必要に応じてプロパティを変更します。

OnLaunched は、DebugSettings 値を変更するのに適した場所です。

DebugSettings で有効になっているすべてのモードでは、デバッガーがアタッチされている必要はありません。 たとえば、デバッガーなしでタイルとしてアクティブ化した場合でも、 EnableFrameRateCounter に関連付けられているフレーム レート カウンターは、その設定で実行されるアプリに表示されます。

運用環境のコードで DebugSettings プロパティを明示的に設定しないでください。

プロパティ

EnableFrameRateCounter

フレーム レートとフレームごとの CPU 使用率情報を表示するかどうかを示す値を取得または設定します。 これらは、アプリの実行中にウィンドウ クロムにカウンターのオーバーレイとして表示されます。
FailFastOnErrors

XAML エラーがエラーを返すのではなく、すぐに FailFast を発生させるかどうかを示す値を取得または設定します。
IsBindingTracingEnabled

アプリの実行時に Microsoft Visual Studio のバインド トレース機能を利用するかどうかを示す値を取得または設定します。 エンゲージされ、バインド エラーが発生すると、 BindingFailed イベントが発生し、エラー情報がネイティブ デバッグ出力に記録されます。
IsTextPerformanceVisualizationEnabled

アプリの実行時に Microsoft Visual Studio のテキスト パフォーマンス視覚化機能を利用するかどうかを示す値を取得または設定します。
IsXamlResourceReferenceTracingEnabled

アプリの実行時に Microsoft Visual Studio の XAML リソース参照トレース機能を利用するかどうかを示す値を取得または設定します。 エンゲージされ、XAML リソース参照エラーが発生すると、イベントが発生し、 XamlResourceReferenceFailed エラー情報がネイティブ デバッグ出力に記録されます。
LayoutCycleDebugBreakLevel

デバッガー ブレークポイントをトリガーするレイアウト サイクル トレース イベントのレベルを示す値を取得または設定します。
LayoutCycleTracingLevel

レイアウト サイクル トレースがネイティブ デバッガーと記録される詳細レベルに書き込まれるかどうかを示す値を取得または設定します。

イベント

BindingFailed

バインディングを解決できない場合に発生します。
XamlResourceReferenceFailed

XAML リソースへの参照を解決できない場合に発生します。

適用対象

こちらもご覧ください