DebugSettings Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Объявляет поведение определенных аспектов приложения при его запуске в среде отладки.
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- Наследование
- Атрибуты
Примеры
В этом примере показано переопределение 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 при запуске приложения. При задействовании и возникновении ошибки привязки |
| IsTextPerformanceVisualizationEnabled |
Возвращает или задает значение, указывающее, следует ли использовать функцию визуализации производительности текста Microsoft Visual Studio при запуске приложения. |
| IsXamlResourceReferenceTracingEnabled |
Возвращает или задает значение, указывающее, следует ли использовать функцию трассировки ссылок на ресурсы XAML в Microsoft Visual Studio при запуске приложения. При задействовании и возникновении |
| LayoutCycleDebugBreakLevel |
Возвращает или задает значение, указывающее уровень событий трассировки цикла макета, которые запускают точку останова отладчика. |
| LayoutCycleTracingLevel |
Возвращает или задает значение, указывающее, записывается ли трассировка цикла макета в собственный отладчик и уровень детализации, который записывается. |
События
| BindingFailed |
Происходит, когда не удается разрешить привязку . |
| XamlResourceReferenceFailed |
Происходит, когда не удается разрешить ссылку на ресурс XAML. |