Traçage et instrumentation d'applications

Le traçage vous permet de contrôler l'exécution de votre application lorsque celle-ci s'exécute. Vous pouvez ajouter l'instrumentation de traçage et de débogage à votre application .NET Framework lors de son développement. Vous pouvez l'utiliser lors du développement et après le déploiement de l'application. Vous pouvez utiliser les classes System.Diagnostics.Trace, System.Diagnostics.Debug et System.Diagnostics.TraceSource pour enregistrer les informations relatives aux erreurs et à l'exécution de l'application dans des journaux, des fichiers texte ou d'autres appareils en vue d'une analyse ultérieure.

Le fait d'instrumenter votre application, en plaçant des instructions de traçage à des endroits stratégiques de votre code, peut être particulièrement utile pour les applications distribuées. Grâce aux instructions de traçage, vous pouvez instrumenter une application non seulement pour afficher des informations en cas de problème, mais aussi pour contrôler son niveau d'exécution.

La classe TraceSource fournit des fonctionnalités de suivi améliorées et peut être utilisée à la place des méthodes statiques des classes de traçage Trace et Debug plus anciennes. Les classes Trace et Debug familières sont toujours largement utilisées, mais la classe TraceSource est recommandée pour les nouvelles commandes de traçage, telles que TraceEvent et TraceData.

Les classes Trace et Debug sont identiques, à ceci près que les procédures et les fonctions de la classe Trace sont compilées par défaut dans des versions release, mais celles de la classe Debug ne le sont pas.

Les rubriques suivantes contiennent des informations supplémentaires sur l'utilisation de l'instrumentation dans vos applications.

Dans cette section

• Introduction à l'instrumentation et au traçage
  Présente une vue d'ensemble des concepts élémentaires de l'instrumentation et du traçage de code.

• Contrats de code
  Explique comment spécifier des conditions préalables, post-conditions et invariants objet pour marquer et analyser votre code.

• Commutateurs de traçage
  Décrit l'utilisation de commutateurs pour filtrer les messages de traçage en fonction de critères complexes.

• Écouteurs de la trace
  Décrit l'utilisation d'écouteurs pour router les messages de traçage vers des cibles de sortie particulières.

• Comment : tracer le code dans une application
  Décrit les principales étapes relatives à l'instrumentation et au traçage.

• Comment : ajouter des instructions de traçage dans le code d'une application
  Présente plusieurs techniques permettant d'utiliser les messages de traçage et de débogage dans votre application.

• Comment : effectuer une compilation conditionnelle avec Trace et Debug
  Explique comment inclure des options de traçage dans des applications compilées.

• Comment : créer et initialiser les sources de trace
  Indique comment utiliser la classe TraceSource.

Référence

• TraceSource
  Fournit un jeu de méthodes et de propriétés qui aident à effectuer le suivi de l'exécution du code et des messages de trace associés à leur source. C'est l'alternative recommandée aux classes Trace et Debug plus anciennes.

• Trace
  Fournit un ensemble de méthodes et de propriétés qui vous permettent de tracer l'exécution de votre code.

• Debug
  Fournit un jeu de méthodes et de propriétés qui aident à déboguer votre code.

Sections connexes

• Comment : utiliser des TraceSource et des filtres avec des écouteurs de la trace
  Décrit l'utilisation d'une TraceSource associée à un fichier de configuration de l'application.

• Comment : créer et initialiser les sources de trace
  Décrit l'utilisation d'une TraceSource avec et sans fichier de configuration de l'application.

• Préparation du débogage : types de projets C#, F# et Visual Basic
  Fournit des liens vers des rubriques traitant du débogage de code managé.

Historique des modifications

Date	Historique	Motif
Décembre 2010	Des informations supplémentaires sur les sources de trace ont été ajoutées.	Commentaires client.