DebugSettings クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
デバッグ環境でアプリを実行するときのアプリの特定の側面の動作を宣言します
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 DebugSettingsPublic NotInheritable Class DebugSettings- 継承
- 属性
例
この例では、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 のバインド トレース機能を利用するかどうかを示す値を取得または設定します。 エンゲージされ、バインド エラーが発生すると、 |
| IsTextPerformanceVisualizationEnabled |
アプリの実行時に Microsoft Visual Studio のテキスト パフォーマンス視覚化機能を利用するかどうかを示す値を取得または設定します。 |
| IsXamlResourceReferenceTracingEnabled |
アプリの実行時に Microsoft Visual Studio の XAML リソース参照トレース機能を利用するかどうかを示す値を取得または設定します。 エンゲージされ、XAML リソース参照エラーが発生すると、イベントが発生し、 |
| LayoutCycleDebugBreakLevel |
デバッガー ブレークポイントをトリガーするレイアウト サイクル トレース イベントのレベルを示す値を取得または設定します。 |
| LayoutCycleTracingLevel |
レイアウト サイクル トレースがネイティブ デバッガーと記録される詳細レベルに書き込まれるかどうかを示す値を取得または設定します。 |
イベント
| BindingFailed |
バインディングを解決できない場合に発生します。 |
| XamlResourceReferenceFailed |
XAML リソースへの参照を解決できない場合に発生します。 |