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

Article
08/21/2008

Mise à jour : novembre 2007

Supprime un écouteur de la collection Listeners pour une source de trace.

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

<remove name="listenerName" />

Attributs et éléments

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

Attributs

Attribut	Description
name	Attribut requis. Nom de l'écouteur à supprimer de la collection Listeners.

É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.
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.
listeners	Spécifie des écouteurs qui collectent, stockent et routent des messages.

Notes

L'élément <remove> supprime un écouteur spécifié de la collection Listeners pour une source de trace.

Vous pouvez supprimer par programme un élément de la collection Listeners pour une source de trace en appelant la méthode Remove sur la propriété Listeners de l'instance de TraceSource.

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 <remove> avant d'utiliser l'élément <add> pour ajouter l'écouteur console à la collection Listeners pour la source de trace TraceSourceApp.

<configuration>
  <system.diagnostics>
    <sources>
      <source name="TraceSourceApp" switchName="sourceSwitch" 
         switchType="System.Diagnostics.SourceSwitch" >
         <listeners>
           <remove name="Default"/>
           <add name="console" 
             type="System.Diagnostics.ConsoleTraceListener" />
         </listeners>
      </source>
    </sources>
  </system.diagnostics>
</configuration>