Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Aktualisiert: November 2007
Gibt einen Listener an, der Meldungen sammelt, speichert und weiterleitet. Listener leiten die Ablaufverfolgungsausgabe an ein entsprechendes Ziel.
<configuration>-Element
<system.diagnostics>-Element
<trace>-Element
<listeners>-Element für <trace>
<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 |
|---|---|
Fügt der Listeners-Auflistung einen Listener hinzu. |
|
Löscht die Listeners-Auflistung für die Ablaufverfolgung. |
|
Entfernt einen Listener aus der Listeners-Auflistung. |
Ü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 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 Beispiel wird gezeigt, wie das <listeners>-Element verwendet wird, um der Listeners-Auflistung die Listener MyListener und MyEventListener 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>