DebugSettings Classe

  • Référence

Définition

Espace de noms:
Windows.UI.Xaml
Modifier

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)]
/// [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
Héritage
Object Platform::Object IInspectable DebugSettings
Attributs
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

S’applique à

Voir aussi