<filter>-Element für <add> für <listeners> für <source>

Fügt einem Listener in der Listeners-Auflistung für eine Ablaufverfolgungsquelle einen Filter hinzu.

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

Attribute und Elemente

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

Attribute

Attribut	Beschreibung
type	Erforderliches Attribut. Gibt den Typ des Filters an, der von der TraceFilter-Klasse erben soll. Verwenden Sie hierfür entweder den Namespace-qualifizierten Namen des Typs, der der FullName-Eigenschaft des Typs entspricht, oder den vollqualifizierten Typnamen einschließlich der Assemblyinformationen, der der AssemblyQualifiedName-Eigenschaft entspricht. Informationen über vollqualifizierte Typnamen finden Sie unter Angeben vollständig gekennzeichneter Typnamen.
initializeData	Optionales Attribut. Die für die angegebene Filterklasse an den Konstruktor übergebene Zeichenfolge.

type

Erforderliches Attribut.

Gibt den Typ des Filters an, der von der TraceFilter-Klasse erben soll. Verwenden Sie hierfür entweder den Namespace-qualifizierten Namen des Typs, der der FullName-Eigenschaft des Typs entspricht, oder den vollqualifizierten Typnamen einschließlich der Assemblyinformationen, der der AssemblyQualifiedName-Eigenschaft entspricht. Informationen über vollqualifizierte Typnamen finden Sie unter Angeben vollständig gekennzeichneter Typnamen.

initializeData

Optionales Attribut.

Die für die angegebene Filterklasse an den Konstruktor ü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 die Ablaufverfolgungslistener, die Meldungen sammeln, speichern und weiterleiten, sowie die Ebene an, auf der ein Ablaufverfolgungsschalter festgelegt wird.
sources	Enthält Ablaufverfolgungsquellen, die Ablaufverfolgungsmeldungen initiieren.
source	Gibt eine Ablaufverfolgungsquelle an, die Ablaufverfolgungsmeldungen initiiert.
listeners	Enthält Listener, die Meldungen sammeln, speichern und weiterleiten. Listener leiten die Ablaufverfolgungsausgabe an ein entsprechendes Ziel.
add	Fügt der Listeners-Auflistung für eine Ablaufverfolgungsquelle einen Listener hinzu.

Hinweise

Das <filter>-Element muss sich in einem <add>-Element für einen Ablaufverfolgungsquellenlistener befinden, der den Typ des Listeners angibt, nicht nur den Namen eines in einem <sharedListeners>-Element definierten Listeners. Wenn der Listener in einem <sharedListeners>-Element definiert ist, muss der Filter für diesen Listener in diesem Element definiert sein.

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

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie dem Listener console in der Listeners-Auflistung für die Ablaufverfolgungsquelle myTraceSource mithilfe des <filter>-Elements ein Filter hinzugefügt wird. Die Filterereignisebene wird dabei als Error angegeben.

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