Partager via

Élément <filter> pour <add> pour <listeners> pour <source>

  • Article

Ajoute un filtre à un écouteur dans la collection Listeners pour une source de trace.

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

Syntaxe

<filter
  type="traceFilterClassName"
  initializeData="data" />

Attributs et éléments

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

Attributs

Attribut Description
type Attribut requis.

Spécifie le type du filtre, qui doit hériter de la classe TraceFilter. Vous pouvez soit utiliser le nom qualifié par un espace de noms du type, qui correspond à la propriété FullName du type, soit utiliser le nom complet du type avec les informations d’assembly, qui correspond à la propriété AssemblyQualifiedName. Pour plus d’informations sur les noms complets de types, consultez Spécification de noms complets de types.
initializeData Attribut facultatif.

Chaîne transmise au constructeur pour la classe de filtre spécifiée.

Éléments enfants

Aucune.

É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.
listeners Contient les écouteurs qui collectent, stockent et routent les messages. Les écouteurs dirigent la sortie de traçage vers une cible appropriée.
add Ajoute un écouteur à la collection Listeners pour une source de trace.

Notes

L’élément <filter> doit être contenu dans un élément <add> pour un écouteur de source de trace qui spécifie le type de l’écouteur, pas seulement le nom d’un écouteur défini dans une collection <sharedListeners>. Si l’écouteur est défini dans une collection <sharedListeners>, le filtre de cet écouteur doit être défini dans cet élément.

Cet élément peut être utilisé dans le fichier de configuration de l’ordinateur (Machine.config) et dans le fichier de configuration de l’application.

Exemple

L’exemple suivant montre comment utiliser l’élément <filter> pour ajouter un filtre à l’écouteur console dans la collection Listeners pour la source de trace myTraceSource, en spécifiant le niveau d’événement de filtre Error.

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="myTraceSource" 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