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 值的两个属性设置为 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 资源的引用时发生。 |