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


DebugSettings Класс

Определение

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

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
Атрибуты

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

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

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

EnableRedrawRegions

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

FailFastOnErrors

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

IsBindingTracingEnabled

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

IsOverdrawHeatMapEnabled

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

IsTextPerformanceVisualizationEnabled

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

События

BindingFailed

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

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

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