<filter> Element für <add> für <sharedListeners>

  • Artikel

Fügt einen Filter zu einem Listener in der sharedListeners-Sammlung hinzu.

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

Syntax

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Attribut BESCHREIBUNG
type Erforderliches Attribut.

Gibt den Typ des Filters an. Sie können nur den vollständigen Namen des Typs verwenden (im Format der Type.FullName Eigenschaft), oder Sie können den vollqualifizierten Typnamen einschließlich der Assemblyinformationen (im Format der Type.AssemblyQualifiedName -Eigenschaft) verwenden. Informationen zu vollqualifizierten Typnamen finden Sie unter Angeben vollqualifizierter Typnamen.
initializeData Optionales Attribut.

Die an den Konstruktor für die angegebene Klasse übergebene Zeichenfolge.

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Element BESCHREIBUNG
configuration Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.
system.diagnostics Gibt Ablaufverfolgungslistener an, die Meldungen sammeln, speichern und weiterleiten sowie die Ebene, für die ein Ablaufverfolgungsschalter festgelegt ist.
sharedListeners Enthält Listener, auf die jedes Quell- oder Ablaufverfolgungselement verweisen kann.
add Fügt der sharedListeners Auflistung einen Listener hinzu.

Bemerkungen

Wenn ein Listener in einem <add> Element des <sharedListeners> Elements definiert ist, sollte der Filter für diesen Listener in einem <filter> Element definiert werden, das ein untergeordnetes Element des <add> Elements ist.

Dieses Element kann in der Computerkonfigurationsdatei (Machine.config) und in der Anwendungskonfigurationsdatei verwendet werden.

Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie das Element verwenden, um dem <filter> Ablaufverfolgungslistener console in der sharedListeners Auflistung einen Filter hinzuzufügen.

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

Siehe auch