Partager via

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

  • Article

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

<configuration>
  <system.diagnostics>
    <sharedListeners>
      <add>
        <filter>

Syntaxe

<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 du type (au format de la propriété Type.FullName), ou vous pouvez utiliser le nom de type complet incluant 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 complet, consultez Spécification des noms de types complets.
initializeData Attribut facultatif.

Chaîne transmise au constructeur pour la classe 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.
sharedListeners Collection d’écouteurs auxquels toute source ou tout élément de trace peuvent faire référence.
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 devrait ê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 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 de suivi console dans 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>

Voir aussi