<filter>, élément de <add> pour <sharedListeners>

Article
08/21/2008

Mise à jour : novembre 2007

Ajoute un filtre à un écouteur de la collection sharedListeners.

<configuration>, élément
  <system.diagnostics>, élément
    <sharedListeners>, élément
      <add>, élément de <sharedListeners>
        <filter>, élément de <add> pour <sharedListeners>

<filter type="System.Diagnostics.EventTypeFilter" 
  initializeData="Warning" />

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. Vous pouvez utiliser uniquement le nom complet du type (au format de la propriété Type.FullName) ou utiliser le nom de type qualifié complet comprenant les informations d'assembly (au format de la propriété Type.AssemblyQualifiedName). Pour plus d'informations sur la création d'un nom de type qualifié complet, consultez Spécification des noms de types qualifiés complets.
initializeData	Attribut facultatif. Chaîne passée au constructeur pour la classe spécifiée.

type

Attribut requis.

Spécifie le type du filtre. Vous pouvez utiliser uniquement le nom complet du type (au format de la propriété Type.FullName) ou utiliser le nom de type qualifié complet comprenant les informations d'assembly (au format de la propriété Type.AssemblyQualifiedName). Pour plus d'informations sur la création d'un nom de type qualifié complet, consultez Spécification des noms de types qualifiés complets.

initializeData

Attribut facultatif.

Chaîne passée au constructeur pour la classe 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.
sharedListeners	Collection d'écouteurs qui peut être référencée par tout élément source ou de trace.
add	Ajoute un écouteur à la collection sharedListeners.

Notes

Si un écouteur est défini dans un élément <add> de l'élément <sharedListeners>, le filtre de cet écouteur doit être défini dans un élément <filter>, qui est un enfant de l'élément <add>.

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 de la trace console de la collection sharedListeners.

<configuration>
  <system.diagnostics>
    <sources>
      <source name="myTraceSource" >
        <listeners>
          <add name="console" />
          <remove name="Default" />
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add name="console" 
        type="System.Diagnostics.ConsoleTraceListener" >
        <filter type="System.Diagnostics.EventTypeFilter" 
          initializeData="Error" />
      </add>
    </sharedListeners>
  </system.diagnostics>
</configuration>