Поделиться через

DebugSettings Класс

  • Ссылка

Определение

Пространство имен:
Microsoft.UI.Xaml
Изменить

Объявляет поведение определенных аспектов приложения при его запуске в среде отладки.

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 DebugSettings
Public NotInheritable Class DebugSettings
Наследование
Object Platform::Object IInspectable DebugSettings
Атрибуты
ContractVersionAttribute MarshalingBehaviorAttribute

Примеры

В этом примере показано переопределение OnLaunched, которое обращается к Application.DebugSettings и задает двум свойствам одноэлементного значения DebugSettings значение true. Контекстом этого кода является код программной части 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

Возвращает или задает значение, указывающее, следует ли отображать сведения о частоте кадров и использовании ЦП для каждого кадра. Они отображаются в виде наложения счетчиков в хроме окна во время работы приложения.
FailFastOnErrors

Возвращает или задает значение, указывающее, вызывают ли ошибки XAML немедленный failFast, а не возвращают ошибку.
IsBindingTracingEnabled

Возвращает или задает значение, указывающее, следует ли использовать функцию трассировки привязки Microsoft Visual Studio при запуске приложения. При задействовании и возникновении ошибки привязки BindingFailed возникает событие, а сведения об ошибке регистрируются в выходных данных отладки в собственном коде.
IsTextPerformanceVisualizationEnabled

Возвращает или задает значение, указывающее, следует ли использовать функцию визуализации производительности текста Microsoft Visual Studio при запуске приложения.
IsXamlResourceReferenceTracingEnabled

Возвращает или задает значение, указывающее, следует ли использовать функцию трассировки ссылок на ресурсы XAML в Microsoft Visual Studio при запуске приложения. При задействовании и возникновении XamlResourceReferenceFailed ошибки ссылки на ресурс XAML возникает событие, а сведения об ошибке регистрируются в выходных данных отладки в собственном коде.
LayoutCycleDebugBreakLevel

Возвращает или задает значение, указывающее уровень событий трассировки цикла макета, которые запускают точку останова отладчика.
LayoutCycleTracingLevel

Возвращает или задает значение, указывающее, записывается ли трассировка цикла макета в собственный отладчик и уровень детализации, который записывается.

События

BindingFailed

Происходит, когда не удается разрешить привязку .
XamlResourceReferenceFailed

Происходит, когда не удается разрешить ссылку на ресурс XAML.

Применяется к

См. также раздел