Activation du traçage pour une page

Vous pouvez vérifier si le traçage est activé ou désactivé pour une page grâce à l'attribut Trace de la directive @ Page. Indépendamment du fait que vous écriviez ou non des messages dans le journal des traces, lorsque vous activez le traçage et que la page est demandée, ASP.NET ajoute une série de tables contenant des informations sur les performances relatives à la demande de page.

Le traçage est désactivé par défaut. Si vous n'incluez pas un attribut Trace dans votre page, les informations de traçage ne sont pas collectées et les instructions trace que vous écrivez n'apparaissent pas sur la page.

Pour activer le traçage pour une page

1. Incluez une directive @ Page au début de votre fichier .aspx. Incluez l'attribut Trace et affectez-lui la valeur true.

   <%@ Page Trace="true" %>
   

   Remarque sur la sécurité   Lorsque le traçage est activé pour une page, les informations de traçage sont affichées sur n'importe quel navigateur faisant une demande pour la page du serveur. Le traçage affiche des informations sensibles telles que les valeurs de variables serveur et peut par conséquent constituer une menace pour la sécurité. Assurez-vous de désactiver le traçage de la page avant de porter votre application vers un serveur de production. Pour ce faire, affectez la valeur false à l'attribut Trace ou supprimez ce dernier.

2. Facultativement, incluez l'attribut TraceMode pour spécifier l'ordre dans lequel vous souhaitez que vos messages de trace apparaissent. Affectez la valeur SortByTime à l'attribut pour trier les messages dans l'ordre où ils sont traités. Affectez la valeur SortByCategory à l'attribut pour les trier selon les catégories que vous avez spécifiées dans les appels de méthode Trace.Warn et Trace.Write dans votre page ou votre code de contrôle serveur.

   L'exemple suivant, lorsqu'il est inclus en haut d'une page, trie par catégorie les messages de trace de la page et du contrôle serveur contenu dans cette page.

   <%@ Page Language="VB" Trace="True" TraceMode="SortByCategory" %>
   

La capture d'écran suivante illustre une page avec des informations de traçage ajoutées à la fin de la sortie de la page.

Traçage de la page

Voir aussi

TraceContext, classe | Page, classe | Fonctionnalité de traçage ASP.NET | @ Page | Écriture de messages de trace