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

Artikel
08/20/2008

Aktualisiert: November 2007

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

<configuration>-Element
  <system.diagnostics>-Element
    <sharedListeners>-Element
      <add>-Element für <sharedListeners>
        <filter>-Element für <add> für <sharedListeners>

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

Attribute und Elemente

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

Attribute

Attribut	Beschreibung
type	Erforderliches Attribut. Gibt den Typ des Filters an. Sie können entweder nur den vollständigen Namen des Typs (im Format der Type.FullName-Eigenschaft) oder den vollqualifizierten Typnamen einschließlich der Assemblyinformationen (im Format der Type.AssemblyQualifiedName-Eigenschaft) verwenden. Informationen über das Erstellen eines vollqualifizierten Typnamens finden Sie unter Angeben vollständig gekennzeichneter Typnamen.
initializeData	Optionales Attribut. Die für die angegebene Klasse an den Konstruktor übergebene Zeichenfolge.

type

Erforderliches Attribut.

Gibt den Typ des Filters an. Sie können entweder nur den vollständigen Namen des Typs (im Format der Type.FullName-Eigenschaft) oder den vollqualifizierten Typnamen einschließlich der Assemblyinformationen (im Format der Type.AssemblyQualifiedName-Eigenschaft) verwenden. Informationen über das Erstellen eines vollqualifizierten Typnamens finden Sie unter Angeben vollständig gekennzeichneter Typnamen.

initializeData

Optionales Attribut.

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

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Element	Beschreibung
configuration	Das Stammelement in jeder Konfigurationsdatei, das von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.
system.diagnostics	Gibt die Ablaufverfolgungslistener, die Meldungen sammeln, speichern und weiterleiten, sowie die Ebene an, auf der ein Ablaufverfolgungsschalter festgelegt wird.
sharedListeners	Eine Auflistung von Listenern, auf die jedes source-Element bzw. trace-Element verweisen kann.
add	Fügt der sharedListeners-Auflistung einen Listener hinzu.

Hinweise

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

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

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie dem Ablaufverfolgungslistener console in der sharedListeners-Auflistung mithilfe des <filter>-Elements ein Filter hinzugefügt wird.

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