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.
.gif "Remarque") Remarque |
|---|
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 |
|
Membre de configuration |
|
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)
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