Élément <listeners> pour <trace>

Article
05/10/2023

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

<configuration>
  <system.diagnostics>
    <trace>
      <listeners>

Syntaxe

<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

Aucune.

Éléments enfants

Élément	Description
<add>	Ajoute un écouteur à la collection `Listeners`.
<clear>	Efface la collection `Listeners` de la trace.
<remove>	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 les écouteurs qui collectent, stockent et acheminent les messages de traçage.

Notes

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

Fichier de configuration

Cet élément peut être défini dans le fichier de configuration de l’application ou dans le fichier de configuration de l’ordinateur (Machine.config).

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 appelé MyListener.log et écrit la sortie dans le fichier. 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>