Comment : ajouter des instructions de traçage dans le code d'une application

Mise à jour : novembre 2007

Les méthodes le plus souvent utilisées pour le traçage sont celles qui permettent d'écrire les informations de sortie dans des écouteurs : Write, WriteIf, WriteLine, WriteLineIf, Assert et Fail. Ces méthodes peuvent être réparties en deux catégories : Write, WriteLine et Fail émettent inconditionnellement des informations de sortie, tandis que WriteIf, WriteLineIf et Assert testent une condition booléenne et écrivent ou n'écrivent pas des informations de sortie, en fonction de la valeur de la condition. WriteIf et WriteLineIf émettent des informations de sortie si la condition a la valeur true et Assert émet des informations de sortie si la condition a la valeur false.

Lors de la conception de votre stratégie de traçage et de débogage, vous devriez considérer la manière dont vous souhaitez que vos informations de sortie apparaissent. Plusieurs instructions Write remplies d'informations sans rapport créeront un journal difficile à lire. En outre, l'utilisation de la méthode WriteLine pour placer des instructions connexes sur des lignes séparées peut rendre le groupement d'informations difficile. En général, il est recommandé d'utiliser plusieurs instructions Write si vous souhaitez combiner des informations en provenance de plusieurs sources dans un message informatif unique et l'instruction WriteLine si vous souhaitez créer un message unique et complet.

Pour écrire une ligne complète

• Appelez la méthode WriteLine ou WriteLineIf.

  Un retour chariot est ajouté à la fin du message retourné par cette méthode ; le message suivant retourné par Write, WriteIf, WriteLine ou WriteLineIf commence donc sur la ligne suivante :

  Dim errorFlag As Boolean = False
  Trace.WriteLine("Error in AppendData procedure.")
  Trace.WriteLineIf(errorFlag, "Error in AppendData procedure.") 
  

  bool errorFlag = false;
  System.Diagnostics.Trace.WriteLine ("Error in AppendData procedure.");
  System.Diagnostics.Trace.WriteLineIf(errorFlag, 
     "Error in AppendData procedure.");
  

  boolean errorFlag = false;
  System.Diagnostics.Trace.WriteLine("Error in AppendData procedure.");
  System.Diagnostics.Trace.WriteLineIf(errorFlag, 
     "Error in AppendData procedure.");
  

Pour écrire une ligne partielle

• Appelez la méthode Write ou WriteIf.

  Le message suivant émis par Write, WriteIf, WriteLine ou WriteLineIf commence sur la même ligne que le message émis par l'instruction Write ou WriteIf :

  Dim errorFlag As Boolean = False
  Trace.WriteIf(errorFlag, "Error in AppendData procedure.")
  Debug.WriteIf(errorFlag, "Transaction abandoned.")
  Trace.Write("Invalid value for data request")
  

  bool errorFlag = false;
  System.Diagnostics.Trace.WriteIf(errorFlag, 
     "Error in AppendData procedure.");
  System.Diagnostics.Debug.WriteIf(errorFlag, "Transaction abandoned.");
  Trace.Write("Invalid value for data request");
  

  boolean errorFlag = false;
  System.Diagnostics.Trace.WriteIf(errorFlag, "Error in AppendData procedure.");
  System.Diagnostics.Debug.WriteIf(errorFlag, "Transaction abandoned.");
        System.Diagnostics.Trace.Write("Invalid value for data request");
  

Pour vérifier l'existence de certaines conditions avant ou après l'exécution d'une méthode

• Appelez la méthode Assert.

  Dim I As Integer = 4
  Trace.Assert(I = 5, "I is not equal to 5.")
  

  int I = 4;
  System.Diagnostics.Trace.Assert(I == 5, "I is not equal to 5.");
  

  int I = 4;
  System.Diagnostics.Trace.Assert(I == 5, "I is not equal to 5.");
  

  Remarque :
  Vous pouvez utiliser Assert pour le traçage et le débogage. Cet exemple renvoie la sortie de la pile des appels à n'importe quel écouteur de la collection Listeners. Pour plus d'informations, consultez Assertions dans du code managé et Debug.Assert.

Voir aussi

Tâches

Comment : configurer les commutateurs de trace

Concepts

Introduction à l'instrumentation et au traçage

Commutateurs de traçage

Écouteurs de la trace

Référence

Debug.WriteIf

Debug.WriteLineIf

Trace.WriteIf

Trace.WriteLineIf

Autres ressources

Traçage et instrumentation d'applications