<sharedListeners>-Element

Artikel
09/02/2008

Aktualisiert: November 2007

Enthält Listener, auf die jedes source- bzw. trace-Element verweisen kann. Diese Listener empfangen standardmäßig keine Ablaufverfolgung und können zur Laufzeit nicht abgerufen werden. Listener, die als freigegeben gekennzeichnet sind, können anhand des Namens zu Quellen oder Ablaufverfolgungen hinzugefügt werden.

<configuration>-Element
<system.diagnostics>-Element
<sharedListeners>-Element

<sharedListeners> 
  <add>...</add>
</sharedListeners>

Attribute und Elemente

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

Attribute

Keine.

Untergeordnete Elemente

Element	Beschreibung
<add>-Element für <listeners> für <trace>	Fügt der sharedListeners-Auflistung einen Listener 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 das Stammelement für den ASP.NET-Konfigurationsabschnitt an.

Hinweise

Ein Listener wird beim Hinzufügen zu einer freigegebenen Listener-Auflistung noch nicht aktiv. Er muss darüber hinaus einer Ablaufverfolgungsquelle oder einer Ablaufverfolgung hinzugefügt werden, indem er der Listeners-Auflistung des entsprechenden Ablaufverfolgungselements hinzugefügt wird. Die in .NET Framework enthaltenen Listenerklassen sind von der TraceListener-Klasse abgeleitet.

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

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie der Listeners-Auflistung für die TraceSource-Klasse und die Trace-Klasse mithilfe des <sharedListeners>-Elements der Listener console hinzugefügt wird. Der Ablaufverfolgungslistener für die Konsole gibt Ablaufverfolgungsinformationen durch Aufrufen von TraceSource oder Trace an die Konsole aus.

<system.diagnostics>
  <sources>
    <source name="mySource" switchName="sourceSwitch value="Verbose" >
      <listeners>
        <add name="console" />
      </listeners>
    </source>
  </sources>  
  <sharedListeners>    <add name="console" type="System.Diagnostics.ConsoleTraceListener" >      <filter type="System.Diagnostics.EventTypeFilter"         initializeData="Warning" />    </add>  </sharedListeners>
  <trace>
    <listeners>
      <add name="console" />
    </listeners>
  </trace>
</system.diagnostics>

Siehe auch

Konzepte

Ablaufverfolgungslistener

Referenz

Schema für Ablaufverfolgungs- und Debugeinstellungen

TraceListener

Freigeben über