Partager via


trace, élément (Schéma des paramètres ASP.NET)

Configure le service de traçage du code d'ASP.NET qui contrôle la collecte, le stockage et l'affichage des résultats de traçage.

<trace 
   enabled="true|false"
   localOnly="true|false"
   pageOutput="true|false"
   requestLimit="integer" 
   mostRecent="true|false"
   writeToDiagnosticsTrace="true|false"
   traceMode="SortByTime|SortByCategory"
/>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut

Description

enabled

Attribut Boolean facultatif.

Spécifie si le traçage est activé pour une application. Le traçage doit être activé pour permettre l'utilisation de la visionneuse Trace.axd. Par défaut, la visionneuse Trace.axd est ajoutée à l'élément httpHandlers.

La valeur par défaut est false.

localOnly

Attribut Boolean facultatif.

Spécifie si la visionneuse de trace (Trace.axd) est disponible uniquement sur le serveur Web hôte. Si la valeur est false, la visionneuse de trace est disponible à partir de n'importe quel ordinateur. Par défaut, la visionneuse Trace.axd est ajoutée à l'élément httpHandlers.

La valeur par défaut est true.

mostRecent

Attribut Boolean facultatif.

Spécifie si la sortie de traçage de niveau application la plus récente est affichée et si les données de trace antérieures aux limites définies par requestLimit sont ignorées. Si la valeur est false, les données de trace sont affichées pour les demandes jusqu'à ce que la valeur de l'attribut requestLimit soit atteinte.

Cet attribut est une nouveauté de .NET Framework version 2.0.

La valeur par défaut est false.

pageOutput

Attribut Boolean facultatif.

Spécifie si la sortie de trace est rendue à la fin de chaque page. Si la valeur est false, la sortie de trace est accessible uniquement via l'utilitaire de traçage.

La valeur par défaut est false.

requestLimit

Attribut Int32 facultatif.

Spécifie le nombre de demandes de traçage à stocker sur le serveur. Si la limite est atteinte et que l'attribut mostRecent a la valeur false, le traçage est automatiquement désactivé.

La limite de requête maximale est 10 000. Si une valeur supérieure à 10 000 est spécifiée, elle est arrondie sans avertissement préalable à 10 000 par ASP.NET.

La valeur par défaut est 10.

traceMode

Attribut TraceDisplayMode facultatif.

Spécifie l'ordre d'affichage des informations de traçage.

L'attribut traceMode peut avoir l'une des valeurs suivantes :

ValeurDescription
SortByCategory Indique que les informations de traçage sont affichées en fonction des catégories définies par l'utilisateur, classées par ordre alphabétique.
SortByTime Indique que les informations de traçage sont affichées dans l'ordre de leur traitement.

La valeur par défaut est SortByTime.

writeToDiagnosticsTrace

Attribut Boolean facultatif.

Spécifie si les messages de trace ASP.NET sont envoyés à l'infrastructure de traçage System.Diagnostics pour tous les écouteurs inscrits pour afficher des messages Trace. Pour plus d'informations, consultez l'élément trace de system.diagnostics.

Cet attribut est une nouveauté de .NET Framework version 2.0.

La valeur par défaut est false.

Éléments enfants

Aucun

Éléments parents

Élément

Description

configuration

Élément racine requis dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.

system.web

Spécifie l'élément racine des paramètres de configuration ASP.NET dans un fichier de configuration et contient des éléments de configuration qui configurent des applications Web ASP.NET et contrôlent le comportement des applications.

Notes

Lorsque le traçage est activé, chaque demande de page génère des messages de trace qui peuvent être ajoutés à la sortie de page ou stockés dans un journal des traces de l'application. Vous pouvez utiliser la visionneuse de traçage ASP.NET (Trace.axd) pour consulter le contenu du journal des traces. Par défaut, Trace.axd est ajouté à l'élément httpHandlers.

RemarqueRemarque

En général, vous ne devez pas activer le traçage dans un site Web actif car cette fonctionnalité peut parfois afficher des informations de configuration sensibles à quiconque consulte les pages du site Web.Le traçage est prévu uniquement à des fins de débogage.Si l'attribut localOnly a la valeur true, les informations de traçage sont affichées uniquement pour les demandes de localhost.En outre, si <deployment retail=true> est défini dans le fichier Web.config, le traçage est désactivé.

Vous pouvez utiliser les propriétés et les méthodes dans la classe Trace pour instrumenter les versions release. L'instrumentation vous permet de surveiller l'intégrité de votre application en exécutant celle-ci dans des conditions de configuration réelles. Le traçage vous aide à isoler les problèmes et à les résoudre sans interrompre un système en cours d'exécution.

Pour que le traçage entre en vigueur, vous devez recompiler votre application avec le jeu d'indicateurs de suivi. Pour ce faire, affectez à l'attribut compilerOptions la valeur ="/d:TRACE" dans la ligne de configuration du compilateur de langage qui doit prendre en charge le traçage. Consultez <compiler>, élément.

Configuration par défaut

L'élément trace par défaut n'est pas configuré explicitement dans le fichier Machine.config ou dans le fichier Web.config racine. Cependant, il s'agit de la configuration par défaut retournée par l'application dans le .NET Framework 2.0 et versions ultérieures.

<trace 
   enabled="false" 
   localOnly="true" 
   mostRecent="false" 
   pageOutput="false" 
   requestLimit="10" 
   traceMode="SortByTime" 
   writeToDiagnosticsTrace="false" 
/>

L'élément trace par défaut est configuré dans le fichier Machine.config des versions 1.0 et 1.1 du .NET Framework.

<trace
   enabled="false"
   localOnly="true"
   pageOutput="false"
   requestLimit="10"
   traceMode="SortByTime"
/>

Exemple

L'exemple de code suivant montre comment spécifier des paramètres de configuration du traçage.

<configuration>
  <system.web>
    <trace enabled="true" 
      pageOutput="true"
      requestLimit="15"
      mostRecent="true" />
    <system.web>
</configuration>

Informations sur les éléments

Gestionnaire de section de configuration

TraceSection

Membre de configuration

TraceSection

Emplacements configurables

Machine.config

Web.config racine

Web.config au niveau de l'application

Web.config de niveau répertoire virtuel ou physique

Spécifications

Microsoft Internet Information Services (IIS) version 5.0 ou ultérieure

.NET Framework

Microsoft Visual Studio

Voir aussi

Tâches

Comment : afficher des informations de traçage ASP.NET avec la visionneuse de trace

Comment : configurer des répertoires spécifiques à l'aide des paramètres d'emplacement

Comment : verrouiller des paramètres de configuration ASP.NET

Référence

system.web, élément (Schéma des paramètres ASP.NET)

configuration, élément (Schéma des paramètres généraux)

<trace>, élément

System.Configuration

System.Web.Configuration

TraceSection

Trace

Concepts

Vue d'ensemble du traçage ASP.NET

Hiérarchie du fichier de configuration ASP.NET et héritage

Sécurisation de la configuration ASP.NET

Scénarios de configuration ASP.NET

Autres ressources

Paramètres généraux de configuration (ASP.NET)

Paramètres de configuration ASP.NET

Administration de site Web ASP.NET

API de configuration ASP.NET