DebugSettings クラス

リファレンス

定義

名前空間:: Windows.UI.Xaml

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

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

public ref class DebugSettings sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DebugSettings final

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DebugSettings final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DebugSettings

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 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 ThreadingAttribute

Windows の要件

デバイスファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

例

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

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

注釈

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

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

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

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

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1809	17763	FailFastOnErrors

プロパティ

EnableFrameRateCounter	フレームレートとフレームごとの CPU 使用率情報を表示するかどうかを示す値を取得または設定します。これらは、アプリの実行中にウィンドウクロムにカウンターのオーバーレイとして表示されます。
EnableRedrawRegions	各フレームを再描画するアプリ UI サーフェイスの領域を強調表示するかどうかを示す値を取得または設定します。
FailFastOnErrors	XAML エラーがエラーを返すのではなく、すぐに FailFast を発生させるかどうかを示す値を取得または設定します。
IsBindingTracingEnabled	アプリの実行時に Microsoft Visual Studio のバインドトレース機能を利用するかどうかを示す値を取得または設定します。
IsOverdrawHeatMapEnabled	オーバードロー操作を視覚化するデバッグ設定を有効にする値を取得または設定します。この視覚化は、グラフィックス処理が多いレイアウト、アニメーション、およびその他の操作を検出するアプリケーション開発時に役立ちます。
IsTextPerformanceVisualizationEnabled	アプリの実行時に Microsoft Visual Studio のテキストパフォーマンス視覚化機能を利用するかどうかを示す値を取得または設定します。

イベント

BindingFailed

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

適用対象