DebugSettings Classe

Définition

Espace de noms:

Windows.UI.Xaml

Déclare le comportement de certains aspects de l’application lorsqu’elle est exécutée dans un environnement de débogage

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

Héritage

Object Platform::Object IInspectable DebugSettings

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Cet exemple montre un remplacement OnLaunched qui accède à Application.DebugSettings et définit deux propriétés de la valeur singleton DebugSettings sur true. Le contexte de ce code étant le code-behind app.xaml, il fait référence à l’objet Application créé pour l’application.

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

Remarques

Cette classe ne peut pas être construite. Obtenez la valeur à partir de Application.DebugSettings , puis modifiez les propriétés si nécessaire.

OnLaunched est un bon endroit pour modifier les valeurs DebugSettings.

Tous les modes activés par DebugSettings ne nécessitent pas l’attachement d’un débogueur. Par exemple, le compteur de fréquence d’images associé à EnableFrameRateCounter s’affiche dans une application qui s’exécute avec ce paramètre, même si vous l’activez en tant que vignette sans le débogueur.

Ne laissez pas de propriétés DebugSettings explicitement définies dans votre code de production.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1809	17763	FailFastOnErrors

Propriétés

EnableFrameRateCounter	Obtient ou définit une valeur qui indique s’il faut afficher la fréquence d’images et les informations d’utilisation de l’UC par image. Celles-ci s’affichent sous la forme d’une superposition de compteurs dans le chrome de la fenêtre pendant l’exécution de l’application.
EnableRedrawRegions	Obtient ou définit une valeur qui indique s’il faut mettre en surbrillance les zones de la surface de l’interface utilisateur de l’application qui sont redessinées chaque image.
FailFastOnErrors	Obtient ou définit une valeur qui indique si les erreurs XAML provoquent un FailFast immédiat au lieu de retourner une erreur.
IsBindingTracingEnabled	Obtient ou définit une valeur qui indique s’il faut engager la fonctionnalité de suivi de liaison de Microsoft Visual Studio lors de l’exécution de l’application.
IsOverdrawHeatMapEnabled	Obtient ou définit une valeur qui active un paramètre de débogage qui visualise les opérations de overdraw. Cette visualisation est utile pendant le développement d’applications pour détecter la disposition, l’animation et d’autres opérations nécessitant beaucoup de traitement graphique.
IsTextPerformanceVisualizationEnabled	Obtient ou définit une valeur qui indique s’il faut activer la fonctionnalité de visualisation des performances de texte de Microsoft Visual Studio lors de l’exécution de l’application.

Événements

BindingFailed

Se produit lorsqu’une liaison ne peut pas être résolue.

Voir aussi

• DebugSettings
• Présentation détaillée de la liaison de données
• Meilleures pratiques en matière de performances pour