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

Artikel
06/05/2023

Entfernt einen Listener aus der Listeners-Sammlung für eine Ablaufverfolgungsquelle.

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

Syntax

<remove name="listenerName" />

Attribute und Elemente

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

Attribute

attribute	Beschreibung
`name`	Erforderliches Attribut. Der Name des Listeners, der aus der `Listeners`-Auflistung entfernt werden soll.

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 <remove>-Element entfernt einen angegebenen Listener aus der Listeners-Auflistung für eine Überwachungsquelle.

Sie können ein Element programmgesteuert aus der Listeners-Auflistung für eine Überwachungsquelle entfernen, indem Sie die Remove-Methode für die Listeners-Eigenschaft der TraceSource-Instanz aufrufen.

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

Beispiel

Das folgende Beispiel zeigt, wie Sie das <remove>-Element vor dem <add>-Element verwenden, um den Listener console der Listeners-Auflistung für die Überwachungsquelle TraceSourceApp hinzuzufügen.

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="TraceSourceApp" switchName="sourceSwitch"
         switchType="System.Diagnostics.SourceSwitch" >  
         <listeners>  
           <remove name="Default"/>  
           <add name="console"
             type="System.Diagnostics.ConsoleTraceListener" />  
         </listeners>  
      </source>  
    </sources>  
  </system.diagnostics>  
</configuration>

Share via