Partager via

<trace>, élément

  • Article

Contient des écouteurs qui collectent, stockent et routent des messages de traçage.

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

<trace autoflush="true|false" 
       indentsize="indent value"/>

Attributs et éléments

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

Attributs

Attribut Description

autoflush

Attribut facultatif.

Spécifie si les écouteurs de traçage vident automatiquement la mémoire tampon de sortie après chaque opération d'écriture.

indentsize

Attribut facultatif.

Spécifie le nombre d'espaces pour la mise en retrait.

Autoflush, attribut

Valeur Description

false

Ne vide pas automatiquement la mémoire tampon de sortie. Il s'agit de l'option par défaut.

true

Vide automatiquement la mémoire tampon de sortie.

Éléments enfants

Élément Description

<listeners>

Spécifie un écouteur qui collecte, stocke et route des messages.

É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.

system.diagnostics

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.

Exemple

L'exemple suivant montre comment utiliser l'élément <trace> pour ajouter l'écouteur MyListener à la collection Listeners. MyListener crée un fichier intitulé MyListener.log et écrit la sortie dans celui-ci. L'attribut autoflush a la valeur true. L'écouteur de traçage écrit donc dans le fichier, que la méthode Trace.Flush soit appelée ou non. L'attribut indentsize a la valeur 0. L'écouteur effectue donc une mise en retrait de zéro espace lorsque la méthode Trace.Indent est appelée.

<configuration>
   <system.diagnostics>
      <trace autoflush="true" indentsize="0">
         <listeners>
            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, system version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="c:\myListener.log" />
         </listeners>
      </trace>
   </system.diagnostics>
</configuration>

Voir aussi

Référence

Schéma des paramètres de traçage et de débogage
TraceListener Class
DefaultTraceListener Class
TextWriterTraceListener Class
EventLogTraceListener Class