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

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

<remove name="listenerName" />

Attribute und Elemente

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

Attribute

Attribut	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 die Ablaufverfolgungslistener, die Meldungen sammeln, speichern und weiterleiten, sowie die Ebene an, auf der ein Ablaufverfolgungsschalter festgelegt wird.
sources	Enthält Ablaufverfolgungsquellen, die Ablaufverfolgungsmeldungen initiieren.
source	Gibt eine Ablaufverfolgungsquelle an, die Ablaufverfolgungsmeldungen initiiert.
listeners	Gibt Listener an, die Meldungen sammeln, speichern und weiterleiten.

Hinweise

Das <remove>-Element entfernt einen angegebenen Listener aus der Listeners-Auflistung für eine Ablaufverfolgungsquelle.

Ein Element kann programmgesteuert aus der Listeners-Auflistung für eine Ablaufverfolgungsquelle entfernt werden, indem die Remove-Methode für die Listeners-Eigenschaft der TraceSource-Instanz aufgerufen wird.

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

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie das <remove>-Element verwendet wird, bevor der Listeners-Auflistung für die Ablaufverfolgungsquelle TraceSourceApp der Listener console mithilfe des <add>-Elements hinzugefügt wird.

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