<sharedListeners>-Element

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.

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

Attribute und Elemente

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

Attribute

Keine.

Untergeordnete Elemente

Element	Beschreibungen
<add>-Element für <listeners> für <trace>	Fügt der sharedListeners-Auflistung einen Listener hinzu.

Übergeordnete Elemente

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

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