<add>-Element für <sharedListeners>
Fügt einen Listener zu der sharedListeners
-Sammlung hinzu. sharedListeners
ist eine Auflistung von Listenern, auf die durch eine beliebige <Quelle> oder <Ablaufverfolgung> verwiesen werden kann. Standardmäßig werden Listener in der sharedListeners
-Auflistung nicht in einer Listeners
-Auflistung platziert. Sie müssen einer <Quelle> oder <Ablaufverfolgung> anhand ihres Namens hinzugefügt werden. Es ist nicht möglich, die Listener in der sharedListeners
-Auflistung zur Laufzeit im Code abzurufen.
<configuration>
<system.diagnostics>
<sharedListeners>
<add>
Syntax
<add name="name"
type="TraceListenerClassName, Version, Culture, PublicKeyToken"
initializeData="data"
traceOutputOptions = "None"
/>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.
Attribute
Attribut | Beschreibung |
---|---|
name |
Erforderliches Attribut. Gibt den Namen des Listeners an, der zum Hinzufügen des freigegebenen Listeners zu einer Listeners -Auflistung verwendet wird. |
type |
Erforderliches Attribut. Gibt den Typ des Listeners an. Sie müssen eine Zeichenfolge verwenden, die die unter Angeben vollqualifizierter Typnamen angegebenen Anforderungen erfüllt. |
initializeData |
Optionales Attribut. Die an den Konstruktor für die angegebene Klasse übergebene Zeichenfolge. |
traceOutputOptions |
Optionales Attribut. Die Zeichenfolgendarstellung von mindestens einem TraceOptions-Enumerationsmember, der die in die Ablaufverfolgungsausgabe zu schreibenden Daten angibt. Mehrere Elemente werden durch Kommas getrennt. Der Standardwert lautet „None“. |
Untergeordnete Elemente
Element | BESCHREIBUNG |
---|---|
<filter> | Fügt einen Filter zu einem Listener in der sharedListeners -Sammlung hinzu. |
Übergeordnete Elemente
Element | BESCHREIBUNG |
---|---|
configuration |
Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei. |
system.diagnostics |
Gibt Ablaufverfolgungslistener an, die Meldungen sammeln, speichern und weiterleiten sowie die Ebene, für die ein Ablaufverfolgungsschalter festgelegt ist. |
sharedListeners |
Enthält Listener, auf die jedes Quell- oder Ablaufverfolgungselement verweisen kann. |
Bemerkungen
Die listener-Klassen, die mit dem .NET Framework ausgeliefert werden, werden von der TraceListener-Klasse abgeleitet. Der Wert für das name
-Attribut wird verwendet, um den freigegebenen Listener einer Listeners
-Auflistung für eine Ablaufverfolgung oder eine Ablaufverfolgungsquelle hinzuzufügen. Der Wert für das initializeData
-Attribut hängt vom Typ des Listeners ab, den Sie erstellen. Nicht alle Ablaufverfolgungslistener erfordern, dass Sie initializeData
angeben.
Hinweis
Wenn Sie das initializeData
-Attribut verwenden, wird möglicherweise die Compilerwarnung „Das Attribut ‚initializeData‘ ist nicht deklariert.“ angezeigt. Diese Warnung tritt auf, weil die Konfigurationseinstellungen gegen die abstrakte Basisklasse TraceListener überprüft werden, die das initializeData
-Attribut nicht erkennt. In der Regel können Sie diese Warnung für Implementierungen von Ablaufverfolgungslistenern ignorieren, die über einen Konstruktor verfügen, der einen Parameter akzeptiert.
Die folgende Tabelle zeigt die Ablaufverfolgungslistener, die im .NET Framework enthalten sind, und beschreibt den Wert ihrer initializeData
-Attribute.
Ablaufverfolgungslistener-Klasse | initializeData-Attributwert |
---|---|
ConsoleTraceListener | Der useErrorStream -Wert für den ConsoleTraceListener-Konstruktor. Legen Sie das initializeData -Attribut auf „true “ fest, um die Ablaufverfolgungs- und Debugausgabe in den Standardfehlerstream zu schreiben. Legen Sie es auf „false “ fest, um in den Standardausgabestream zu schreiben. |
DelimitedListTraceListener | Der Name der Datei, in die der DelimitedListTraceListener schreibt. |
System.Diagnostics.EventLogTraceListener | Der Name einer vorhandenen Ereignisprotokollquelle. |
System.Diagnostics.EventSchemaTraceListener | Der Name der Datei, in die der EventSchemaTraceListener schreibt. |
System.Diagnostics.TextWriterTraceListener | Der Name der Datei, in die der TextWriterTraceListener schreibt. |
XmlWriterTraceListener | Der Name der Datei, in die der XmlWriterTraceListener schreibt. |
Konfigurationsdatei
Dieses Element kann in der Computerkonfigurationsdatei (Machine.config) und in der Anwendungskonfigurationsdatei verwendet werden.
Beispiel
Das folgende Beispiel zeigt, wie man <add>
-Elemente verwendet, um den TextWriterTraceListenertextListener
zur sharedListeners
-Auflistung hinzuzufügen. textListener
wird anhand seines Namens zur Listeners
-Auflistung für die Ablaufverfolgungsquelle TraceSourceApp
hinzugefügt. Der textListener
-Listener schreibt die Ablaufverfolgungsausgabe in die Datei „myListener.log“.
<configuration>
<system.diagnostics>
<sources>
<source name="TraceSourceApp" switchName="sourceSwitch"
switchType="System.Diagnostics.SourceSwitch">
<listeners>
<add name="console"
type="System.Diagnostics.ConsoleTraceListener"/>
<add name="textListener"/>
<remove name="Default"/>
</listeners>
</source>
</sources>
<sharedListeners>
<add name="textListener"
type="System.Diagnostics.TextWriterTraceListener"
initializeData="myListener.log"/>
</sharedListeners>
<switches>
<add name="sourceSwitch" value="Warning"/>
</switches>
</system.diagnostics>
</configuration>
Siehe auch
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für