DebugSettings Classe

Référence

Définition

Espace de noms:: Microsoft.UI.Xaml

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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(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

Héritage: Object Platform::Object IInspectable DebugSettings

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute

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 est le code-behind app.xaml. Fait donc this 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 nécessitent qu’un débogueur soit attaché. 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.

Propriétés

EnableFrameRateCounter	Obtient ou définit une valeur qui indique s’il faut afficher les informations relatives à la fréquence d’images et à l’utilisation de l’UC par image. Ils s’affichent sous la forme d’une superposition de compteurs dans le chrome de la fenêtre pendant l’exécution de l’application.
FailFastOnErrors	Obtient ou définit une valeur qui indique si les erreurs XAML provoquent un FailFast immédiat au lieu de renvoyer 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. Lorsqu’une erreur de liaison est engagée et qu’une erreur de liaison se produit, l’événement `BindingFailed` est déclenché et les informations d’erreur sont enregistrées dans la sortie de débogage native.
IsTextPerformanceVisualizationEnabled	Obtient ou définit une valeur qui indique s’il faut engager la fonctionnalité de visualisation des performances du texte de Microsoft Visual Studio lors de l’exécution de l’application.
IsXamlResourceReferenceTracingEnabled	Obtient ou définit une valeur qui indique s’il faut engager la fonctionnalité de suivi des références de ressources XAML de Microsoft Visual Studio lors de l’exécution de l’application. En cas d’engagement et qu’une erreur de référence de ressource XAML se produit, l’événement `XamlResourceReferenceFailed` est déclenché et les informations d’erreur sont enregistrées dans la sortie de débogage native.
LayoutCycleDebugBreakLevel	Obtient ou définit une valeur qui indique le niveau des événements de suivi du cycle de disposition qui déclenchent un point d’arrêt du débogueur.
LayoutCycleTracingLevel	Obtient ou définit une valeur qui indique si le suivi du cycle de disposition est écrit dans le débogueur natif et le niveau de détail enregistré.

Événements

BindingFailed	Se produit lorsqu’une liaison ne peut pas être résolue.
XamlResourceReferenceFailed	Se produit lorsqu’une référence à une ressource XAML ne peut pas être résolue.

S’applique à

Partager via