<trace> Élément

Article
09/05/2023

Contient les écouteurs qui collectent, stockent et acheminent les messages de traçage.

<configuration>
<system.diagnostics>
<trace>

Syntaxe

XML

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

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 trace vident automatiquement la mémoire tampon de sortie après chaque opération d’écriture.
`indentsize`	Attribut facultatif. Spécifie le nombre d’espaces à mettre en retrait.
`useGlobalLock`	Attribut facultatif. Indique si le verrou global doit être utilisé.

Attribut autoflush

Valeur	Description
`false`	Ne vide pas automatiquement la mémoire tampon de sortie. Il s’agit de la valeur par défaut.
`true`	Vide automatiquement la mémoire tampon de sortie.

Attribut useGlobalLock

Valeur	Description
`false`	N’utilise pas le verrou global si l’écouteur est thread-safe. Sinon, utilise le verrou global.
`true`	Utilise le verrou global, que l’écouteur soit thread-safe ou non. Il s’agit de la valeur par défaut.

Éléments enfants

Élément	Description
<listeners>	Spécifie un écouteur qui collecte, stocke et route les 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 trace qui collectent, stockent et acheminent les messages, ainsi que le niveau auquel un commutateur de trace 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 nommé MyListener.log et écrit la sortie dans le fichier. L’attribut useGlobalLock est défini sur false, ce qui entraîne l’utilisation du verrou global si l’écouteur de trace est thread safe. L’attribut autoflush est défini sur true, ce qui entraîne l’écriture de l’écouteur de trace dans le fichier, que la méthode Trace.Flush soit appelée ou non. L’attribut indentsize est défini sur 0 (zéro), ce qui entraîne l’appel de l’écouteur à zéro espaces lorsque la méthode Trace.Indent est appelée.

XML

<configuration>  
   <system.diagnostics>  
      <trace useGlobalLock="false" 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>

Partager via