Fonctionnalité de traçage ASP.NET

ASP.NET introduit une nouvelle fonctionnalité qui vous permet d'afficher des informations de diagnostic relatives à une unique demande de page ASP.NET simplement en l'activant pour votre page ou votre application. Cette fonctionnalité, appelée traçage, vous permet d'écrire des instructions de débogage directement dans votre code sans avoir à les supprimer de votre application lorsqu'elle est déployée vers des serveurs de production. Vous pouvez écrire des variables ou des structures dans une page, déclarer si une condition est remplie ou simplement effectuer le traçage du chemin d'exécution de votre page ou de votre application.

Vous devez activer le traçage pour la page ou l'application pour pouvoir collecter et afficher les messages ainsi que d'autres informations de traçage. Lorsque vous activez le traçage, deux choses se produisent :

• ASP.NET ajoute une série de tables d'informations de diagnostic immédiatement après la sortie de la page. Les informations sont aussi transmises à une application de visionneuse de trace (si vous avez activé le traçage pour l'application).
• ASP.NET affiche vos messages de diagnostic personnalisés dans la table Informations de traçage des données de performance ajoutées.

Les informations de diagnostic et les messages de traçage que vous spécifiez sont ajoutés à la sortie de la page envoyée au navigateur qui a émis la demande. Facultativement, vous pouvez visualiser ces informations à partir d'une visionneuse de trace séparée (Trace.axd) qui affiche les informations de traçage pour chaque page dans une application donnée. Ces informations peuvent vous aider à clarifier les erreurs ou les résultats indésirables lorsque ASP.NET traite une demande de page.

Les instructions trace sont traitées et affichées uniquement lorsque le traçage est activé. Vous pouvez contrôler l'affichage du traçage sur une page, sur une visionneuse de trace ou sur les deux.

Dans cette section

• Activation du traçage pour une page
  Explique comment activer le traçage pour une page, inclure les instructions trace dans la sortie de la page et interpréter les messages de trace.
• Écriture de messages de trace
  Décrit comment utiliser les méthodes TraceContext.Write et TraceContext.Warn pour écrire des instructions dans le journal des traces.
• Activation du traçage au niveau de l'application
  Décrit en détail comment activer le traçage pour une application entière par l'intermédiaire du système de configuration ASP.NET. Explique aussi comment utiliser la visionneuse de trace, qui est un module HTTP accessible à partir de votre navigateur Web.
• Lecture des informations de traçage
  Décrit en détail les informations à votre disposition lorsque vous visualisez les informations de traçage ajoutées à la page ou à la visionneuse de trace.

Rubriques connexes

• Création d'applications Web ASP.NET
  Présente les fonctionnalités d'ASP.NET et décrit ce que vous pouvez accomplir en les utilisant pour la programmation.
• TraceContext, classe
  Capture et présente les détails d'exécution relatifs à une demande Web.