DebugSettings Clase

Definición

Espacio de nombres:

Microsoft.UI.Xaml

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

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

Herencia

Object Platform::Object IInspectable DebugSettings

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

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 this 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 incluso si se activa como un icono sin el depurador.

No deje ninguna propiedad DebugSettings establecida explícitamente en el código de producción.

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.
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. Cuando se activa y se produce un error de enlace, se genera el BindingFailed evento y la información de error se registra en la salida de depuración nativa.
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.
IsXamlResourceReferenceTracingEnabled	Obtiene o establece un valor que indica si se debe interactuar con la característica de seguimiento de referencia de recursos XAML de Microsoft Visual Studio cuando se ejecuta la aplicación. Cuando se produce un error de referencia de recursos XAML y se activa, se genera el XamlResourceReferenceFailed evento y se registra la información de error en la salida de depuración nativa.
LayoutCycleDebugBreakLevel	Obtiene o establece un valor que indica el nivel de eventos de seguimiento del ciclo de diseño que desencadenan un punto de interrupción del depurador.
LayoutCycleTracingLevel	Obtiene o establece un valor que indica si el seguimiento del ciclo de diseño se escribe en el depurador nativo y el nivel de detalle que se registra.

Eventos

BindingFailed	Se produce cuando no se puede resolver un enlace .
XamlResourceReferenceFailed	Se produce cuando no se puede resolver una referencia a un recurso XAML.

Consulte también

• DebugSettings
• Enlace de datos en profundidad
• Desarrollo de aplicaciones de Windows: procedimientos recomendados