Comment : créer et initialiser les commutateurs de trace

Mise à jour : novembre 2007

Pour pouvoir utiliser les commutateurs de traçage, vous devez tout d'abord les créer et les placer dans votre code. Il existe deux classes prédéfinies à partir desquelles vous pouvez créer des objets commutateur : BooleanSwitch et TraceSwitch. Vous devriez utiliser BooleanSwitch si vous souhaitez uniquement contrôler l'apparition ou non des messages de trace et TraceSwitch si vous avez besoin de faire la distinction entre les différents niveaux de traçage. Si vous utilisez un commutateur TraceSwitch, vous pouvez définir vos propres messages de débogage et les associer à différents niveaux de traçage. Vous pouvez utiliser les deux types de commutateurs pour le traçage ou le débogage. Par défaut, un commutateur BooleanSwitch est désactivé et un commutateur TraceSwitch est réglé sur le niveau TraceLevel.Off. Vous pouvez créer et placer les commutateurs de traçage dans toute partie de votre code susceptible de les utiliser.

Bien que vous puissiez définir des niveaux de traçage et d'autres options de configuration dans le code, il est recommandé d'utiliser le fichier de configuration pour gérer l'état de vos commutateurs. La gestion de la configuration de vos commutateurs dans le système de configuration vous offre en effet plus de souplesse : vous pouvez activer et désactiver plusieurs commutateurs et changer de niveau sans que vous n'ayez à recompiler votre application. Pour plus d'informations, consultez Configuration des commutateurs de traçage.

Pour créer et initialiser un commutateur de traçage

  1. Définissez un commutateur de type BooleanSwitch ou de type TraceSwitch et définissez le nom et la description de ce commutateur.

  2. Configurez votre commutateur de traçage. Pour plus d'informations, consultez Configuration des commutateurs de traçage.

    Le code suivant crée deux commutateurs, un de chaque type :

    Dim dataSwitch As New BooleanSwitch("Data", "DataAccess module")
    Dim generalSwitch As New TraceSwitch("General", "Entire application")
    
    System.Diagnostics.BooleanSwitch dataSwitch = 
       new System.Diagnostics.BooleanSwitch("Data", "DataAccess module");
    System.Diagnostics.TraceSwitch generalSwitch = 
       new System.Diagnostics.TraceSwitch("General", 
       "Entire application");
    
    System.Diagnostics.BooleanSwitch dataSwitch =
       new System.Diagnostics.BooleanSwitch("Data", "DataAccess module");
    System.Diagnostics.TraceSwitch generalSwitch =
       new System.Diagnostics.TraceSwitch("General", 
       "Entire application");
    

Voir aussi

Tâches

Comment : configurer les commutateurs de trace

Concepts

Commutateurs de traçage

Introduction à l'instrumentation et au traçage