<listeners>-Element für die <trace>

Artikel
05/10/2023

Gibt einen Listener an, der Nachrichten sammelt, speichert und weiterleitet. Listener leiten die Ablaufverfolgungsausgabe an ein geeignetes Ziel weiter.

<configuration>
  <system.diagnostics>
    <trace>
      <listeners>

Syntax

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

Attribute und Elemente

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

Attribute

Keine

Untergeordnete Elemente

Element	BESCHREIBUNG
<add>	Fügt einen Listener zu der `Listeners`-Sammlung hinzu.
<clear>	Löscht die `Listeners`-Sammlung für die Ablaufverfolgung.
<remove>	Entfernt einen Listener aus der `Listeners`-Sammlung.

Übergeordnete Elemente

Element	BESCHREIBUNG
`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 Ablaufverfolgungsmeldungen sammeln, speichern und weiterleiten.

Bemerkungen

Die Klassen Debug und Trace verwenden dieselbe Listenersammlung. Wenn Sie der Sammlung in einer dieser Klassen ein Listenerobjekt hinzufügen, verwendet die andere Klasse denselben Listener. Die Listenerklassen, die mit dem .NET Framework ausgeliefert werden, werden von der TraceListener-Klasse abgeleitet.

Konfigurationsdatei

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

Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie das Element <Listener> verwenden, um die Listener MyListener und MyEventListener der Listeners-Sammlung hinzuzufügen. MyListener erstellt eine Datei namens MyListener.log und schreibt die Ausgabe in die Datei. MyEventListener schreibt einen Eintrag in das 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>