<filter>, élément de <add> pour <listeners> pour <source>

Article
08/21/2008

Mise à jour : novembre 2007

Ajoute un filtre à un écouteur dans 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>
          <add>, élément de <listeners> pour <trace>
            <filter>, élément de <add> pour <listeners> pour <source>

<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 utiliser le nom qualifié par un espace de noms du type, lequel correspond à la propriété FullName du type. Vous pouvez, par ailleurs, utiliser le nom qualifié complet du type, avec les informations d'assembly, lequel correspond à la propriété AssemblyQualifiedName. Pour plus d'informations sur les noms qualifiés complets, consultez Spécification des noms de types qualifiés complets.
initializeData	Attribut facultatif. Chaîne passée au constructeur pour la classe de filtre spécifiée.

type

Attribut requis.

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

initializeData

Attribut facultatif.

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

É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	Contient des écouteurs qui collectent, stockent et routent des 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> d'un écouteur de source de la trace qui spécifie le type de l'écouteur, pas simplement le nom d'un écouteur défini dans un élément <sharedListeners>. Si l'écouteur est défini dans un élément <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 machine (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 Error comme niveau d'événement du filtre.

<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>