<clear>, élément de <listeners> pour <trace>

Article
08/21/2008

Mise à jour : novembre 2007

Efface le contenu de la collection Listeners de l'élément trace.

<configuration>, élément
  <system.diagnostics>, élément
    <trace>, élément
      <listeners>, élément de <trace>
        <clear>, élément de <listeners> pour <trace>

<clear/>

Attributs et éléments

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

Attributs

Aucun.

Éléments enfants

Aucun.

É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.
trace	Contient des écouteurs qui collectent, stockent et routent des messages de traçage.
listeners	Contient des écouteurs qui collectent, stockent et routent des messages. Les écouteurs dirigent la sortie de traçage vers une cible appropriée.

Notes

L'élément <clear> supprime tous les écouteurs de la collection Listeners de l'élément trace. Vous pouvez utiliser l'élément <clear> avant d'utiliser l'élément <add> pour garantir l'absence de tout autre écouteur actif dans la collection.

Vous pouvez effacer par programme le contenu de la collection Listeners en appelant la méthode Clear sur la propriété Trace.Listeners (System.Diagnostics.Trace.Listeners.Clear()).

Cet élément peut être utilisé dans le fichier de configuration machine (Machine.config) et dans le fichier de configuration de l'application.

Remarque :
L'élément <clear> supprime le DefaultTraceListener de la collection Listeners, modifiant ainsi le comportement des méthodes Debug.Assert, Trace.Assert, Debug.Fail et Trace.Fail. L'appel d'une méthode Assert ou Fail provoque normalement l'affichage d'un message. Toutefois, le message ne s'affiche pas si DefaultTraceListener n'est pas dans la collection Listeners.

Exemple

L'exemple suivant montre comment utiliser l'élément <clear> avant d'utiliser l'élément <add> pour ajouter l'écouteur console à la collection Listeners de l'élément trace.

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="4">
      <listeners>
        </clear>
        <add name="console" 
          type="System.Diagnostics.ConsoleTraceListener" >
          <filter type="System.Diagnostics.EventTypeFilter" 
            initializeData="Error" />
        </add>
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>