<filtrer> Element <pour ajouter de <la> pour <les auditeurs> pour les traces><filter> Element for <add> for <listeners> for <trace>

Ajoute un filtre à un Listeners auditeur de la collection pour une trace.Adds a filter to a listener in the Listeners collection for a trace.

<configuration><configuration>
  <system.diagnostics>  <system.diagnostics>
    <trace>    <trace>
      <auditeurs>      <listeners>
        <ajouter>        <add>
          <filtrer>          <filter>

SyntaxeSyntax

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

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

AttributAttribute DescriptionDescription
type Attribut requis.Required attribute.

Spécifie le type de filtre, TraceFilter qui devrait hériter de la classe.Specifies the type of the filter, which should inherit from the TraceFilter class. Vous pouvez utiliser le nom du type, qui correspond à FullName la propriété du type, ou vous pouvez utiliser le nom AssemblyQualifiedName de type entièrement qualifié, y compris les informations d’assemblage, qui correspond à la propriété.You can use the namespace-qualified name of the type, which corresponds to the type's FullName property, or you can use the fully qualified type name including the assembly information, which corresponds to the AssemblyQualifiedName property. Pour plus d’informations sur les noms de type entièrement qualifiés, voir spécifier des noms de type entièrement qualifiés.For information about fully qualified type names, see Specifying Fully Qualified Type Names.
initializeData Attribut facultatif.Optional attribute.

La chaîne est passée au constructeur pour la classe de filtre spécifiée.The string passed to the constructor for the specified filter class.

É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.
add Ajoute un écouteur à la collection Listeners.Adds a listener to the Listeners collection.

Notes Remarks

L’élément <filter> doit être <add> contenu dans un élément pour un auditeur de trace qui spécifie le type de l’auditeur, et pas seulement le nom d’un auditeur défini dans un <>d’écoutes partagées .The <filter> element must be contained in an <add> element for a trace listener that specifies the type of the listener, not just the name of a listener defined in a <sharedListeners>. Si l’auditeur est défini dans un <>d’écoute partagé, le filtre de cet auditeur doit être défini dans cet élément.If the listener is defined in a <sharedListeners>, the filter for that listener must be defined in that element.

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 <filter> comment utiliser l’élément pour console ajouter Listeners un filtre à l’auditeur Errorde la collection pour la trace, en spécifiant le niveau d’événement de filtre comme .The following example shows how to use the <filter> element to add a filter to the listener console in the Listeners collection for trace, specifying the filter event level as Error.

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

Voir aussiSee also