Partager via

<trace> Élément

Contient des écouteurs qui collectent, stockent et routent les messages de suivi.

trace system.diagnostics <>>>

Syntaxe

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

Attributes

Caractéristique Descriptif
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 Descriptif
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.

useGlobalLock Attribute

Valeur Descriptif
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 Descriptif
<Auditeurs> Spécifie un écouteur qui collecte, stocke et route les messages.

Éléments parents

Élément Descriptif
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 suivi qui collectent, stockent et routent les messages et le niveau où un commutateur de trace est défini.

Example

L’exemple suivant montre comment utiliser l’élément <trace> pour ajouter l’écouteur MyListener à la Listeners collection. MyListener crée un fichier nommé MyListener.log et écrit la sortie dans le fichier. L’attribut useGlobalLock est défini falsesur , ce qui entraîne l’utilisation du verrou global si l’écouteur de trace est thread safe. L’attribut autoflush est défini truesur , ce qui entraîne l’écriture de l’écouteur de trace dans le fichier, que la Trace.Flush méthode soit appelée. L’attribut indentsize est défini sur 0 (zéro), ce qui entraîne le retrait des espaces zéro lorsque la Trace.Indent méthode 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>

Voir aussi

  • Last updated on