Compartir a través de


DebugSettings Clase

Definición

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)]
/// [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
Herencia
Object Platform::Object IInspectable DebugSettings
Atributos

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 .

Se aplica a

Consulte también