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

Article
08/21/2008

Mise à jour : novembre 2007

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

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

<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

Aucun.

Éléments enfants

Élément	Description
<add>, élément de <listeners> pour <source>	Ajoute un écouteur à la collection Listeners.
<remove>, élément de <listeners> pour <source>	Supprime un écouteur de la collection Listeners.
<clear>, élément de <listeners> pour <source>	Efface le contenu de 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 traçage qui collectent, stockent et routent des messages, ainsi que le niveau auquel un commutateur de traçage est défini.
sources	Contient des sources de trace qui initient des messages de traçage.
source	Spécifie une source de trace qui initie le traçage des messages.

Notes

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 un écouteur de la trace console à la source mySource et pour supprimer l'écouteur de la 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>

Voir aussi

Concepts

Écouteurs de la trace

Référence

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

TraceListener

Partager via