<system.diagnostics>, élément

Article
05/10/2023

Spécifie les écouteurs de trace qui collectent, stockent et acheminent les messages, ainsi que le niveau auquel un commutateur de trace est défini.

<configuration>
<system.diagnostics>

Syntaxe

<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

Aucune.

Éléments enfants

Élément	Description
<assert>	Indique si une boîte de message doit s’afficher quand 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 performances.
<sharedListeners>	Contient des écouteurs auxquels toute source ou tout élément de trace peuvent faire référence. Les écouteurs identifiés en tant qu’écouteurs partagés peuvent être ajoutés à des sources ou des traces par nom.
<sources>	Spécifie les sources de trace qui lancent des messages de traçage.
<switches>	Contient des commutateurs de trace et les niveaux où ils sont définis.
<trace>	Contient les écouteurs qui collectent, stockent et acheminent les 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 trace et un écouteur de trace à l’intérieur de l’élément <system.diagnostics>. Le commutateur de trace General est défini sur le niveau TraceLevel. L’écouteur de trace myListener crée un fichier appelé MyListener.log et écrit la sortie dans le fichier.

Notes

Dans .NET Framework 2.0, vous pouvez spécifier la valeur d’un commutateur avec du texte. Par exemple, vous pouvez spécifier true pour un BooleanSwitch ou utiliser le texte représentant une valeur d'énumération comme 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>

Partager via