DebugSettings クラス

  • リファレンス

定義

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

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

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

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

適用対象

こちらもご覧ください