<trace>, élément

Article
08/21/2008

Mise à jour : novembre 2007

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"
       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 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.
useGlobalLock	Attribut facultatif. Indique si le verrouillage global doit être utilisé.

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.

useGlobalLock

Attribut facultatif.

Indique si le verrouillage global doit être utilisé.

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.

useGlobalLock, attribut

Valeur	Description
false	N'utilise le verrouillage global que si l'écouteur est thread-safe.
true	Utilise le verrouillage 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 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. Lorsque l'attribut useGlobalLock a la valeur false, le verrouillage global n'est pas utilisé si l'écouteur de la trace est thread-safe. Lorsque l'attribut autoflush a la valeur true, l'écouteur de la trace écrit dans le fichier, que la méthode Trace.Flush soit appelée ou non. Lorsque l'attribut indentsize a la valeur 0 (zéro), l'écouteur met en retrait des espaces nuls lorsque la méthode Trace.Indent est appelée.

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