<add>-Element für <sharedListeners>

Artikel
08/10/2011

Fügt der sharedListeners-Auflistung einen Listener hinzu. sharedListeners ist eine Auflistung von Listenern, auf die jedes <source>-Element bzw. <trace>-Element verweisen 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.

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

Attribute und Elemente

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

Attribute

Attribute	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	Beschreibungen
<filter>-Element für <add> für <sharedListeners>	Fügt einem Listener in der sharedListeners-Auflistung einen Filter hinzu.

Übergeordnete Elemente

Element	Beschreibungen
configuration	Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.
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.

Hinweis
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.

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

Im folgenden Beispiel wird dargestellt, wie <add>-Elemente verwendet werden, um den TextWriterTraceListener textListener zu der sharedListeners-Auflistung hinzuzufügen. 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>