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

Artikel
06/02/2023

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

<configuration>
  <system.diagnostics>
    <sources>
      <source>
        <listeners>
          <add>
            <filter>

Syntax

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

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, der von der TraceFilter-Klasse geerbt werden soll. Sie können den namespacequalifizierten Namen des Typs verwenden, der der FullName-Eigenschaft des Typs entspricht, oder Sie können den vollqualifizierten Typnamen einschließlich der Assemblyinformationen verwenden, der der AssemblyQualifiedName-Eigenschaft entspricht. Informationen zu vollqualifizierten Typnamen finden Sie unter Angeben vollqualifizierter Typnamen.

initializeData Optionales Attribut.

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

Attribut	Beschreibung
`type`	Erforderliches Attribut. Gibt den Typ des Filters an, der von der TraceFilter-Klasse geerbt werden soll. Sie können den namespacequalifizierten Namen des Typs verwenden, der der FullName-Eigenschaft des Typs entspricht, oder Sie können den vollqualifizierten Typnamen einschließlich der Assemblyinformationen verwenden, der der AssemblyQualifiedName-Eigenschaft entspricht. Informationen zu vollqualifizierten Typnamen finden Sie unter Angeben vollqualifizierter Typnamen.
`initializeData`	Optionales Attribut. Die an den Konstruktor für die angegebene filter-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.
`sources`	Enthält die Ablaufverfolgungsquellen, die die Ablaufverfolgungsmeldungen initiieren.
`source`	Gibt eine Ablaufverfolgungsquelle an, die die Ablaufverfolgungsmeldungen initiiert.
`listeners`	Enthält Listener, die Meldungen sammeln, speichern und weiterleiten. Listener leiten die Ablaufverfolgungsausgabe an ein geeignetes Ziel weiter.
`add`	Fügt einen Listener zu der `Listeners`-Sammlung für eine Ablaufverfolgungsquelle hinzu.

Bemerkungen

Das <filter>-Element muss in einem <add>-Element für einen Ablaufverfolgungs-Quelllistener enthalten sein, der den Typ des Listeners angibt, nicht nur den Namen eines in einem <sharedListeners> definierten Listeners. Wenn der Listener in einem <sharedListeners> 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

Das folgende Beispiel zeigt, wie Sie das <filter>-Element verwenden, um dem Listener console in der Listeners-Auflistung für die Ablaufverfolgungsquelle myTraceSource einen Filter hinzuzufügen, wobei die Filterereignisebene als Error angegeben wird.

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

Freigeben über