trace, élément (Schéma des paramètres ASP.NET)
[Cette documentation constitue un aperçu et pourra faire l'objet de modifications dans les versions ultérieures. Des rubriques vierges sont incluses en tant qu'espaces réservés.]
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.
Notes
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 |
Configuration requise |
Microsoft Internet Information Services (IIS) version 5.0 ou ultérieure .NET Framework Microsoft Visual Studio |
Voir aussi
Tâches
How to: View Trace Information with the Trace Viewer
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
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
ASP.NET Configuration File Hierarchy
Autres ressources
Paramètres généraux de configuration (ASP.NET)
Paramètres de configuration ASP.NET