<system.diagnostics>, élément

Article
08/21/2008

Mise à jour : novembre 2007

Spécifie les écouteurs de traçage qui collectent, stockent et routent des messages, ainsi que le niveau auquel un commutateur de traçage est défini.

<configuration>, élément
<system.diagnostics>, élément

<system.diagnostics> 
</system.diagnostics>

Attributs et éléments

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

Attributs

Aucun.

Éléments enfants

Élément	Description
<assert>	Spécifie s'il convient d'afficher un message lorsque vous appelez la méthode Debug.Assert ; spécifie également le nom du fichier dans lequel écrire les messages.
<performanceCounters>	Spécifie la taille de la mémoire globale partagée par les compteurs de performance.
<sharedListeners>	Contient des écouteurs qui peuvent être référencés par n'importe quel élément trace ou source. Les écouteurs identifiés comme des écouteurs partagés peuvent être ajoutés aux sources ou aux traces par nom.
<sources>	Spécifie les sources de trace qui initient des messages de traçage.
<switches>	Contient des commutateurs de traçage et les niveaux auxquels les commutateurs de traçage sont définis.
<trace>	Contient des écouteurs qui collectent, stockent et routent des messages de traçage.

Éléments parents

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

Exemple

L'exemple suivant montre comment incorporer un commutateur de traçage et un écouteur de traçage dans l'élément <system.diagnostics>. Le commutateur de traçage General est défini au niveau TraceLevel.Error. L'écouteur de traçage myListener crée un fichier MyListener.log et écrit la sortie dans ce fichier.

Remarque :
Dans le .NET Framework version 2.0, vous pouvez utiliser le texte pour spécifier la valeur d'un commutateur. Par exemple, vous pouvez spécifier true pour un BooleanSwitch ou utiliser le texte représentant une valeur d'énumération telle que Error pour un TraceSwitch. La ligne <add name="myTraceSwitch" value="Error" /> équivaut à <add name="myTraceSwitch" value="1" />.

<configuration>
   <system.diagnostics>
      <switches>
         <add name="General" value="4" />
      </switches>
      <trace autoflush="true" indentsize="2">
         <listeners>
            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="MyListener.log" traceOutputOptions="ProcessId, LogicalOperationStack, Timestamp, ThreadId, Callstack, DateTime" />
         </listeners>
      </trace>
   </system.diagnostics>
</configuration>

Voir aussi

Référence

Schéma des paramètres de traçage et de débogage

Trace

Debug

Partager via