<add>-Element für <sharedListeners>

Artikel
08/20/2008

Aktualisiert: November 2007

Fügt der sharedListeners-Auflistung einen Listener hinzu. sharedListeners stellt eine Auflistung von Listenern dar, auf die von <source>-Element oder <trace>-Element beliebig verwiesen werden kann. Listener in der sharedListeners-Auflistung werden standardmäßig nicht in eine Listeners-Auflistung eingefügt. Sie müssen <source>-Element oder <trace>-Element anhand des Namens hinzugefügt werden. Die Listener in der sharedListeners-Auflistung können zur Laufzeit nicht im Code abgerufen werden.

<configuration>-Element
  <system.diagnostics>-Element
    <sharedListeners>-Element
      <add>-Element für <listeners> für <source>

<add name="name" 
  type="TraceListenerClassName, Version, Culture, PublicKeyToken"
  initializeData="data"/>

Attribute und Elemente

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

Attribute

Attribut	Beschreibung
name	Erforderliches Attribut. Gibt den Namen des Listeners an, anhand dessen der freigegebene Listener einer Listeners-Auflistung hinzugefügt wird.
type	Erforderliches Attribut. Gibt den Typ des Listeners an. Sie müssen eine Zeichenfolge verwenden, die die in Angeben vollständig gekennzeichneter Typnamen angegebenen Anforderungen erfüllt.
initializeData	Optionales Attribut. Die für die angegebene Klasse an den Konstruktor übergebene Zeichenfolge.

name

Erforderliches Attribut.

Gibt den Namen des Listeners an, anhand dessen der freigegebene Listener einer Listeners-Auflistung hinzugefügt wird.

type

Erforderliches Attribut.

Gibt den Typ des Listeners an. Sie müssen eine Zeichenfolge verwenden, die die in Angeben vollständig gekennzeichneter Typnamen angegebenen Anforderungen erfüllt.

initializeData

Optionales Attribut.

Die für die angegebene Klasse an den Konstruktor übergebene Zeichenfolge.

Untergeordnete Elemente

Element	Beschreibung
<filter>-Element für <add> für <sharedListeners>	Fügt einem Listener in der sharedListeners-Auflistung einen Filter hinzu.

Ü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 die Ablaufverfolgungslistener, die Meldungen sammeln, speichern und weiterleiten, sowie die Ebene an, auf der ein Ablaufverfolgungsschalter festgelegt wird.
sharedListeners	Eine Auflistung von Listenern, auf die jedes source-Element bzw. trace-Element verweisen kann.

Hinweise

Die im Lieferumfang des .NET Framework enthaltenen Listenerklassen sind von der TraceListener-Klasse abgeleitet. Der freigegebene Listener wird der Listeners-Auflistung für eine Ablaufverfolgung oder Ablaufverfolgungsquelle anhand des Werts des name-Attributs hinzugefügt. Der Wert des initializeData-Attributs hängt von der Art des erstellten Listeners ab. initializeData muss nicht für alle Ablaufverfolgungslistener angegeben werden.

Tipp

Wenn Sie das initializeData-Attribut verwenden, wird möglicherweise die Compilerwarnung "Das Attribut "initializeData" ist nicht deklariert" angezeigt. Diese Warnung wird angezeigt, da die Konfigurationseinstellungen anhand der abstrakten 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 mit einem Parameter verfügen.

In der folgenden Tabelle werden die im Lieferumfang des .NET Framework enthaltenen Ablaufverfolgungslistener aufgeführt und die Werte der zugehörigen initializeData-Attribute erläutert.

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, oder 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 von EventSchemaTraceListener geschrieben wird.
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 veranschaulicht die Verwendung von <add>-Elementen zum Hinzufügen von TextWriterTraceListenertextListener zur sharedListeners-Auflistung. textListener wird der Listeners-Auflistung für die Ablaufverfolgungsquelle TraceSourceApp nach Namen 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>