Cliquez pour évaluer et commenter
MSDN
MSDN Library
Visual Studio 2005
Documentation Visual Studio
Débogage et dépannage

  Passer à l'affichage pour faible bande passante
ASP.NET
Vue d'ensemble du traçage ASP.NET au niveau de l'application

Vous pouvez configurer des pages individuelles pour afficher des informations de traçage. Vous pouvez également configurer le fichier Web.config de l'application afin que toutes les pages affichent des informations de traçage sauf celles dont le traçage a été explicitement désactivé. La configuration du traçage au niveau de l'application est utile car vous évitez ainsi de devoir apporter des modifications aux pages individuelles pour activer et désactiver le traçage sur celles-ci.

Vous activez le traçage au niveau de l'application à l'aide de l'élément trace dans le fichier Web.config. Lorsque vous activez le traçage au niveau de l'application, ASP.NET collecte les informations de traçage pour chaque demande faite à l'application, jusqu'au nombre maximal de demandes que vous spécifiez. Le nombre de demandes par défaut est de 10. Lorsque la visionneuse de trace atteint sa limite de demandes, l'application arrête de stocker les demandes de trace. Vous pouvez configurer le traçage pour stocker soit les données de traçage les plus anciennes (en ignorant les éléments plus récents) ou les informations de traçage les plus récentes (en ignorant les éléments plus anciens).

RemarqueRemarque

Lorsque vous activez le traçage pour toute une application dans le fichier Web.config, les informations de traçage sont collectées et traitées pour chaque page de cette application. Pour substituer les paramètres définis au niveau de l'application, affectez à l'attribut Trace dans la directive @ Page la valeur false. Les instructions Write ou Warn que vous incluez dans le code d'une page sont stockées et retournées à la visionneuse de trace uniquement.

Affichage des informations de traçage

Comme c'est généralement le cas avec le traçage de page, vous pouvez consulter les informations de traçage en bas des pages individuelles. Vous pouvez également utiliser la visionneuse de trace (Trace.axd) pour consulter des informations de traçage collectées et mises en cache par ASP.NET lorsque le traçage est activé.

Si vous souhaitez que les informations de traçage apparaissent à la fin de la page à laquelle elles sont associées, vous pouvez affecter à l'attribut PageOutput de l'élément trace la valeur true. Si vous activez le traçage au niveau de l'application mais que vous ne souhaitez pas voir les informations de traçage affichées sur certaines pages, vous pouvez affecter la valeur false à l'attribut Trace dans la directive @ Page de ces pages. Pour plus d'informations sur la configuration de votre application ASP.NET, consultez Vue d'ensemble de la configuration ASP.NET.

Par défaut, le traçage au niveau de l'application peut être affiché seulement sur l'ordinateur du serveur Web local. Pour rendre des informations de traçage de niveau application visibles à des ordinateurs distants, vous pouvez affecter à l'attribut LocalOnly de l'élément trace la valeur false.

RemarqueRemarque

Pour préserver la sécurité de votre application Web, utilisez la fonctionnalité de traçage distant seulement lorsque vous développez ou déployez votre application. Veillez à la désactiver avant de transférer votre application sur les serveurs Web de production en affectant à l'attribut LocalOnly la valeur true dans le fichier Web.config.

L'exemple suivant illustre la configuration du traçage d'une application qui collecte des informations de traçage pour 40 demandes au maximum et permet aux navigateurs installés sur des ordinateurs autres que le serveur d'afficher la visionneuse de trace.

<configuration>
  <system.web>
    <trace enabled="true" requestLimit="40" localOnly="false" />
  </system.web>
</configuration>

Attributs de configuration du traçage

Le tableau suivant répertorie les attributs que vous pouvez utiliser pour modifier le comportement du traçage au niveau de l'application dans l'élément trace du fichier Web.config.

Attribut Description

enabled

true pour activer le traçage de l'application ; sinon, false. La valeur par défaut est false. Vous pouvez substituer ce paramètre pour les pages individuelles en affectant à l'attribut Trace dans la directive @ Page de ces pages la valeur true ou false.

pageOutput

true pour afficher les informations de traçage à la fois dans les pages et dans la visionneuse de trace (Trace.axd) ; sinon, false. La valeur par défaut est false.

RemarqueRemarque

Les pages individuelles pour lesquelles le traçage est activé ne sont pas affectées par ce paramètre.

RequestLimit

Nombre de demandes de trace à stocker sur le serveur. La valeur par défaut est 10.

traceMode

Ordre dans lequel les informations de traçage sont affichées. Affectez-lui le paramètre SortByTime pour effectuer un tri en fonction de l'ordre de traitement des informations. Affectez-lui le paramètre SortByCategory pour effectuer un tri alphabétique en fonction des catégories définies par l'utilisateur. La valeur par défaut est SortByTime.

localOnly

true pour que la visionneuse de trace (Trace.axd) soit uniquement disponible sur le serveur Web hôte ; sinon false. La valeur par défaut est true.

mostRecent

true pour afficher les informations de traçage les plus récentes comme sortie de traçage ; false pour spécifier qu'une fois la valeur requestLimit dépassée, les nouvelles demandes ne sont pas stockées. La valeur par défaut est false.

RemarqueRemarque

Les données de traçage qui dépassent la limite définie par l'attribut requestLimit sont éliminées au profit des données les plus récentes uniquement lorsque mostRecent a la valeur true.

Voir aussi

Contenu de la communauté   Qu'est-ce que le Contenu de la communauté ?
Ajouter du contenu RSS  Annotations
Processing
© 2009 Microsoft Corporation. Tous droits réservés. Conditions d'utilisation  |  Marques  |  Confidentialité
Page view tracker