Élément <listeners> pour <source>

Article
05/09/2023

Ajoute ou supprime des écouteurs dans la collection Listeners pour un TraceSource. Un écouteur dirige la sortie de suivi vers une cible appropriée, telle qu’un journal, une fenêtre ou un fichier de texte.

<configuration>
  <system.diagnostics>
    <sources>
      <source>
        <listeners>

Syntaxe

<listeners>
  <add>...</add>  
  <remove ... />  
  <clear/>  
</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`.
<remove>	Supprime un écouteur de la collection `Listeners`.
<clear>	Efface la collection `Listeners` pour une source de trace.

É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 trace qui collectent, stockent et acheminent les messages, ainsi que le niveau auquel un commutateur de trace est défini.
`sources`	Contient les sources de trace qui lancent des messages de traçage.
`source`	Spécifie une source de trace qui lance des messages de traçage.

Notes

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 un écouteur de trace de console à la source mySource et supprimer l’écouteur de trace par défaut.

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="mySource" switchName="sourceSwitch"
        switchType="System.Diagnostics.SourceSwitch">  
        <listeners>  
          <add name="console"
            type="System.Diagnostics.ConsoleTraceListener">  
            <filter type="System.Diagnostics.EventTypeFilter"
              initializeData="Error"/>  
          </add>  
          <remove name="Default"/>  
        </listeners>  
      </source>  
    </sources>  
    <switches>  
      <add name="sourceSwitch" value="Warning"/>  
    </switches>  
  </system.diagnostics>  
</configuration>

Share via