<sharedListeners>-Element

  • Artikel

Enthält Listener, auf die jedes Quell- oder Ablaufverfolgungselement verweisen kann. Diese Listener erhalten standardmäßig keine Ablaufverfolgungen, und es ist nicht möglich, diese Listener zur Laufzeit abzurufen. Listener, die als freigegebene Listener festgelegt wurden, können Quellen oder Stapelüberwachungen anhand ihres Namens hinzugefügt werden.

<configuration>
  <system.diagnostics>
    <sharedListeners>

Syntax

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

Attribute und Elemente

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

Attribute

Keine

Untergeordnete Elemente

Element BESCHREIBUNG
<add> Fügt einen Listener zu 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 das Stammelement für den ASP.NET-Konfigurationsabschnitt an.

Bemerkungen

Das Hinzufügen eines Listeners zur Sammlung freigegebener Listener macht ihn nicht zu einem aktiven Listener. Es muss weiterhin einer Ablaufverfolgungsquelle oder einer Ablaufverfolgung hinzugefügt werden, indem sie der Listeners Auflistung für dieses Ablaufverfolgungselement hinzugefügt wird. Die Listenerklassen, die mit dem .NET Framework ausgeliefert werden, werden von der TraceListener-Klasse abgeleitet.

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

Beispiel

Das folgende Beispiel zeigt, wie Sie das <sharedListeners>-Element verwenden, um den Listener console der Listeners-Auflistung für die Klassen TraceSource und Trace hinzuzufügen. Der Konsolenablaufverfolgungslistener schreibt Ablaufverfolgungsinformationen über Aufrufe von oder TraceSourceTracein die Konsole.

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

Siehe auch