DebugSettings Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 DebugSettingsPublic NotInheritable Class DebugSettings- Herencia
- Atributos
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 |
| 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 |
| 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. |