<listeners>-Element für <source>

Artikel
09/02/2008

Aktualisiert: November 2007

Fügt der Listeners-Auflistung für eine TraceSource Listener hinzu oder entfernt diese. Ein Listener leitet die Ablaufverfolgungsausgabe an ein entsprechendes Ziel, beispielsweise ein Protokoll, ein Fenster oder eine Textdatei.

<configuration>-Element
  <system.diagnostics>-Element
    <sources>-Element
      <source>-Element
        <listeners>-Element für <source>

<listeners> 
  <add>...</add>
  <remove ... />
  <clear/>
</listeners>

Attribute und Elemente

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

Attribute

Keine.

Untergeordnete Elemente

Element	Beschreibung
<add>-Element für <listeners> für <source>	Fügt der Listeners-Auflistung einen Listener hinzu.
<remove>-Element für <listeners> für <source>	Entfernt einen Listener aus der Listeners-Auflistung.
<clear>-Element für <listeners> für <source>	Löscht die Listeners-Auflistung für eine Ablaufverfolgungsquelle.

Ü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.
sources	Enthält Ablaufverfolgungsquellen, die Ablaufverfolgungsmeldungen initiieren.
source	Gibt eine Ablaufverfolgungsquelle an, die Ablaufverfolgungsmeldungen initiiert.

Hinweise

Konfigurationsdatei

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

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe des <listeners> -Elements der Quelle mySource ein Ablaufverfolgungslistener für eine Konsole hinzugefügt und der Standard-Ablaufverfolgungslistener entfernt wird.

<configuration>
  <system.diagnostics>
    <sources>
      <source name="mySource" 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>

Siehe auch

Konzepte

Ablaufverfolgungslistener

Referenz

Schema für Ablaufverfolgungs- und Debugeinstellungen

TraceListener

Freigeben über