<listeners>-Element für <source>

Artikel
06/06/2023

Fügt Listener in der Listeners-Auflistung für eine TraceSource hinzu oder entfernt sie. Ein Listener leitet die Ablaufverfolgungsausgabe an ein entsprechendes Ziel weiter, beispielsweise ein Protokoll, ein Fenster oder eine Textdatei.

<configuration>
  <system.diagnostics>
    <sources>
      <source>
        <listeners>

Syntax

<listeners>
  <add>...</add>  
  <remove ... />  
  <clear/>  
</listeners>

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 `Listeners`-Sammlung hinzu.
<remove>	Entfernt einen Listener aus der `Listeners`-Sammlung.
<clear>	Löscht die `Listeners`-Sammlung für eine Ablaufverfolgungsquelle.

Übergeordnete Elemente

Element	BESCHREIBUNG
`configuration`	Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.
`system.diagnostics`	Gibt Ablaufverfolgungslistener an, die Meldungen sammeln, speichern und weiterleiten sowie die Ebene, für die ein Ablaufverfolgungsschalter festgelegt ist.
`sources`	Enthält die Ablaufverfolgungsquellen, die die Ablaufverfolgungsmeldungen initiieren.
`source`	Gibt eine Ablaufverfolgungsquelle an, die die Ablaufverfolgungsmeldungen initiiert.

Bemerkungen

Konfigurationsdatei

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

Beispiel

Das folgende Beispiel zeigt, wie Sie das <listeners>-Element verwenden, um der Quelle mySource einen Ablaufverfolgungslistener für die Konsole hinzuzufügen und den standardmäßigen Ablaufverfolgungslistener zu entfernen.

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="mySource" switchName="sourceSwitch"
        switchType="System.Diagnostics.SourceSwitch">  
        <listeners>  
          <add name="console"
            type="System.Diagnostics.ConsoleTraceListener">  
            <filter type="System.Diagnostics.EventTypeFilter"
              initializeData="Error"/>  
          </add>  
          <remove name="Default"/>  
        </listeners>  
      </source>  
    </sources>  
    <switches>  
      <add name="sourceSwitch" value="Warning"/>  
    </switches>  
  </system.diagnostics>  
</configuration>

Freigeben über