<clear>-Element für <listeners> für <source>

Artikel
06/02/2023

Löscht die Listeners-Sammlung für eine Ablaufverfolgungsquelle.

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

Syntax

<clear/>

Attribute und Elemente

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

Attribute

Keine

Untergeordnete Elemente

Keine

Ü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.
`listeners`	Gibt Listener an, die Meldungen sammeln, speichern und weiterleiten.

Bemerkungen

Das <clear>-Element entfernt alle Listener aus der Listeners-Auflistung für eine Ablaufverfolgungsquelle, einschließlich des DefaultTraceListener. Sie können das <clear>-Element vor dem <add>-Element verwenden, um sicherzustellen, dass keine anderen aktiven Listener in der Auflistung vorhanden sind.

Konfigurationsdatei

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

Beispiel

Das folgende Beispiel zeigt, wie Sie das <clear>-Element vor den <add>-Elementen verwenden, um die Listener console und textListener der Listeners-Auflistung für die Ablaufverfolgungsquelle TraceSourceApp hinzuzufügen.

<configuration>  
  <system.diagnostics>  
    <sources>  
       <source name="TraceSourceApp" switchName="sourceSwitch"
         switchType="System.Diagnostics.SourceSwitch">  
        <listeners>  
          <clear/>  
          <add name="console"
            type="System.Diagnostics.ConsoleTraceListener"/>  
          <add name="textListener"/>  
        </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>

Freigeben über