<élément> clair pour <les auditeurs <> pour les> de source<clear> Element for <listeners> for <source>

Efface la collection Listeners pour une source de trace.Clears the Listeners collection for a trace source.

<configuration><configuration>
  <system.diagnostics>  <system.diagnostics>
    <sources>    <sources>
      <source>      <source>
        <auditeurs>        <listeners>
          <clair>          <clear>

SyntaxeSyntax

<clear/>  

Attributs et élémentsAttributes and Elements

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.The following sections describe attributes, child elements, and parent elements.

AttributsAttributes

Aucun.None.

Éléments enfantsChild Elements

Aucun.None.

Éléments parentsParent Elements

ÉlémentElement DescriptionDescription
configuration Élément racine de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.The root element in every configuration file used by the common language runtime and .NET Framework applications.
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.Specifies trace listeners that collect, store, and route messages and the level where a trace switch is set.
sources Contient les sources de trace qui lancent des messages de traçage.Contains trace sources that initiate tracing messages.
source Spécifie une source de trace qui lance des messages de traçage.Specifies a trace source that initiates tracing messages.
listeners Spécifie les auditeurs qui recueillent, stockent et acheminent les messages.Specifies listeners that collect, store, and route messages.

Notes Remarks

L’élément <clear> supprime tous Listeners les auditeurs de la DefaultTraceListenercollection pour une source de trace, y compris le .The <clear> element removes all listeners from the Listeners collection for a trace source, including the DefaultTraceListener. Vous pouvez <clear> utiliser l’élément avant d’utiliser l’élément <add> pour être certain qu’il n’y a pas d’autres auditeurs actifs dans la collection.You can use the <clear> element before using the <add> element to be certain there are no other active listeners in the collection.

Fichier de configurationConfiguration File

Cet élément peut être utilisé dans le fichier de configuration de la machine (Machine.config) et le fichier de configuration d’application.This element can be used in the machine configuration file (Machine.config) and the application configuration file.

 ExempleExample

L’exemple suivant montre <clear> comment utiliser <add> l’élément avant console textListener d’utiliser les éléments pour ajouter les auditeurs et à la Listeners collection pour la source TraceSourceAppde traces .The following example shows how to use the <clear> element before using the <add> elements to add the listeners console and textListener to the Listeners collection for the trace source TraceSourceApp.

<configuration>  
  <system.diagnostics>  
    <sources>  
       <source name="TraceSourceApp" switchName="sourceSwitch"
         switchType="System.Diagnostics.SourceSwitch">  
        <listeners>  
          <clear/>  
          <add name="console"
            type="System.Diagnostics.ConsoleTraceListener"/>  
          <add name="textListener"/>  
        </listeners>  
      </source>  
    </sources>  
    <sharedListeners>  
      <add name="textListener"
        type="System.Diagnostics.TextWriterTraceListener"
        initializeData="myListener.log"/>  
    </sharedListeners>  
    <switches>  
      <add name="sourceSwitch" value="Warning"/>  
    </switches>  
  </system.diagnostics>  
</configuration>

Voir aussiSee also