<listeners> -Element für <trace>

Gibt einen Listener an, der Nachrichten sammelt, speichert und leitet. 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

Keiner.

Untergeordnete Elemente

Element Description
<hinzufügen> Fügt der Listeners Auflistung einen Listener hinzu.
<klar> Löscht die Auflistung für die Listeners Ablaufverfolgung.
<entfernen> Entfernt einen Listener aus der Listeners Auflistung.

Übergeordnete Elemente

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

Bemerkungen

Die klassen und Debug die Trace gleichen Listeners Auflistungen. Wenn Sie der Auflistung in einer dieser Klassen ein Listenerobjekt hinzufügen, verwendet die andere Klasse denselben Listener. Die mit .NET Framework ausgelieferten Listenerklassen werden von der TraceListener Klasse abgeleitet.

Konfigurationsdatei

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

Example

Das folgende Beispiel zeigt, wie Sie das <listeners> Element verwenden, um die Listener MyListener und MyEventListener der Listeners Auflistung hinzuzufügen. MyListener erstellt eine aufgerufene MyListener.log Datei 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

  • Last updated on