<élément> clair pour <les auditeurs <> pour les traces><clear> Element for <listeners> for <trace>

Efface la collection Listeners de la trace.Clears the Listeners collection for trace.

<configuration><configuration>
  <system.diagnostics>  <system.diagnostics>
    <trace>    <trace>
      <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.
trace Contient les écouteurs qui collectent, stockent et acheminent les messages de traçage.Contains listeners that collect, store, and route tracing messages.
listeners Contient des auditeurs qui recueillent, stockent et acheminent des messages.Contains listeners that collect, store, and route messages. Les auditeurs dirigent la sortie de traçage vers une cible appropriée.Listeners direct the tracing output to an appropriate target.

Notes Remarks

L’élément <clear> supprime tous Listeners les auditeurs de la collection pour la trace.The <clear> element removes all listeners from the Listeners collection for trace. 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.

Vous pouvez Listeners effacer la collecte programmatiquement en appelant la Clear méthode sur la Trace.Listeners propriété (System.Diagnostics.Trace.Listeners.Clear()).You can clear the Listeners collection programmatically by calling the Clear method on the Trace.Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

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.

Notes

<clear> L’élément supprime DefaultTraceListener le Listeners de la collection, Debug.Assertmodifiant Trace.Assert Debug.Faille Trace.Fail comportement de la , , , et les méthodes.The <clear> element removes the DefaultTraceListener from the Listeners collection, altering the behavior of the Debug.Assert, Trace.Assert, Debug.Fail, and Trace.Fail methods. L’appel d’une Assert méthode ou Fail une méthode permet normalement l’affichage d’une boîte de message.Calling an Assert or Fail method normally results in the display of a message box. Toutefois, la boîte de message DefaultTraceListener n’est Listeners pas affichée si elle n’est pas dans la collection.However, the message box is not displayed if the DefaultTraceListener is not in the Listeners collection.

 ExempleExample

L’exemple suivant montre <clear> comment utiliser <add> l’élément avant console d’utiliser l’élément pour ajouter l’auditeur à la Listeners collection pour la trace.The following example shows how to use the <clear> element before using the <add> element to add the listener console to the Listeners collection for trace.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <clear/>  
        <add name="console"
          type="System.Diagnostics.ConsoleTraceListener" >  
          <filter type="System.Diagnostics.EventTypeFilter"
            initializeData="Error" />  
        </add>  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>

Voir aussiSee also