<listeners>-Element für <trace>

Artikel
08/10/2011

Gibt einen Listener an, der Meldungen sammelt, speichert und weiterleitet. Listener leiten die Ablaufverfolgungsausgabe an ein entsprechendes Ziel.

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

Attribute und Elemente

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

Attribute

Keine.

Untergeordnete Elemente

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

Übergeordnete Elemente

Element	Beschreibungen
configuration	Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.
system.diagnostics	Gibt das Stammelement für den ASP.NET-Konfigurationsabschnitt an.
trace	Enthält Listener, die Verfolgungsmeldungen sammeln, speichern und weiterleiten.

Hinweise

Die Debug- Klasse und die Trace-Klasse verwenden die gleiche Listeners-Auflistung. Wenn Sie der Auflistung in einer dieser Klassen ein Listener-Objekt hinzufügen, verwendet die andere Klasse denselben Listener. Die im Lieferumfang des .NET Framework enthaltenen Listenerklassen sind von der TraceListener-Klasse abgeleitet.

Konfigurationsdatei

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

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie das <listeners>-Element verwendet wird, um den MyListener-Listener und den MyEventListener-Listener zur -Listeners-Auflistung hinzuzufügen. MyListener erstellt eine Datei mit der Bezeichnung MyListener.log und schreibt die Ausgabe in die Datei. MyEventListener erstellt einen Eintrag im Ereignisprotokoll.

<configuration>
  <system.diagnostics>
    <trace autoflush="true" indentsize="0">
      <listeners>
        <add name="myListener" 
          type="System.Diagnostics.TextWriterTraceListener, 
            system, version=1.0.3300.0, Culture=neutral, 
            PublicKeyToken=b77a5c561934e089" 
          initializeData="c:\myListener.log" />
        <add name="MyEventListener"
          type="System.Diagnostics.EventLogTraceListener, 
            system, version=1.0.3300.0, Culture=neutral, 
            PublicKeyToken=b77a5c561934e089"
          initializeData="MyConfigEventLog"/>
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>

Siehe auch

Referenz

Schema für Ablaufverfolgungs- und Debugeinstellungen

TraceListener