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

Article
08/21/2008

Mise à jour : novembre 2007

Spécifie un écouteur qui collecte, stocke et route des messages. Les écouteurs dirigent la sortie de traçage vers une cible appropriée.

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

<listeners> 
  <add>...</add>
  <clear/>
  <remove ... />
</listeners>

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

Élément	Description
<add>, élément de <listeners> pour <trace>	Ajoute un écouteur à la collection Listeners.
<clear>, élément de <listeners> pour <trace>	Efface le contenu de la collection Listeners de l'élément trace.
<remove>, élément de <listeners> pour <source>	Supprime un écouteur de la collection Listeners.

É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 l'élément racine de la section de configuration ASP.NET.
trace	Contient des écouteurs qui collectent, stockent et routent des messages de traçage.

Notes

Les classes Debug et Trace partagent la même collection Listeners. Si vous ajoutez un objet Listener à la collection dans l'une de ces classes, l'autre classe utilise le même écouteur. Les classes d'écouteur livrées avec le .NET Framework dérivent de la classe TraceListener.

Fichier de configuration

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

Exemple

L'exemple suivant montre comment utiliser l'élément <listeners> pour ajouter les écouteurs MyListener et MyEventListener à la collection Listeners. MyListener crée un fichier intitulé MyListener.log et écrit la sortie dans celui-ci. MyEventListener crée une entrée dans le journal des événements.

<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" />
        <add name="MyEventListener"
          type="System.Diagnostics.EventLogTraceListener, 
            system, version=1.0.3300.0, Culture=neutral, 
            PublicKeyToken=b77a5c561934e089"
          initializeData="MyConfigEventLog"/>
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>

Voir aussi

Référence

Schéma des paramètres de traçage et de débogage

TraceListener

Partager via