DebugSettings Clase

Definición

Espacio de nombres:

Windows.UI.Xaml

Declara cómo se comportan determinados aspectos de la aplicación cuando se ejecuta en un entorno de depuración.

public ref class DebugSettings sealed

/// [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)]
public sealed class DebugSettings

Public NotInheritable Class DebugSettings

Herencia

Object Platform::Object IInspectable DebugSettings

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En este ejemplo se muestra una invalidación OnLaunched que tiene acceso a Application.DebugSettings y establece dos propiedades del valor singleton DebugSettings en true. El contexto de este código es el código subyacente app.xaml, por lo que hace referencia al objeto Application creado para la aplicación.

protected override void OnLaunched(LaunchActivatedEventArgs args) {
    this.DebugSettings.EnableFrameRateCounter = true;
    this.DebugSettings.IsOverdrawHeatMapEnabled = true;
    //...
}

Comentarios

Esta clase no se puede construir. Obtenga el valor de Application.DebugSettings y cambie las propiedades según sea necesario.

OnLaunched es un buen lugar para cambiar los valores de DebugSettings.

No todos los modos habilitados por DebugSettings requieren que se adjunte un depurador. Por ejemplo, el contador de velocidad de fotogramas asociado a EnableFrameRateCounter aparecerá en una aplicación que se ejecuta con esa configuración aunque la active como un icono sin el depurador.

No deje las propiedades DebugSettings establecidas explícitamente en el código de producción.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1809	17763	FailFastOnErrors

Propiedades

EnableFrameRateCounter	Obtiene o establece un valor que indica si se va a mostrar la velocidad de fotogramas y la información de uso de CPU por fotograma. Se muestran como una superposición de contadores en el cromo de la ventana mientras se ejecuta la aplicación.
EnableRedrawRegions	Obtiene o establece un valor que indica si se resaltan las áreas de la superficie de la interfaz de usuario de la aplicación que se vuelven a dibujar cada fotograma.
FailFastOnErrors	Obtiene o establece un valor que indica si los errores XAML provocan un error FailFast inmediato en lugar de devolver un error.
IsBindingTracingEnabled	Obtiene o establece un valor que indica si se debe interactuar con la característica de seguimiento de enlaces de Microsoft Visual Studio cuando se ejecuta la aplicación.
IsOverdrawHeatMapEnabled	Obtiene o establece un valor que habilita una configuración de depuración que visualiza operaciones de sobredraw. Esta visualización es útil durante el desarrollo de aplicaciones para detectar el diseño, la animación y otras operaciones que consumen mucho procesamiento de gráficos.
IsTextPerformanceVisualizationEnabled	Obtiene o establece un valor que indica si se debe interactuar con la característica de visualización de rendimiento de texto de Microsoft Visual Studio cuando se ejecuta la aplicación.

Eventos

BindingFailed

Se produce cuando no se puede resolver un enlace .

Consulte también

• DebugSettings
• Enlace de datos en profundidad
• Procedimientos recomendados de rendimiento para