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 值的两个属性设置为 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

在无法解析 绑定 时发生。

适用于

另请参阅