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

Artikel
09/02/2008

Aktualisiert: November 2007

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

<configuration>-Element
  <system.diagnostics>-Element
    <sources>-Element
      <source>-Element
        <listeners>-Element für <trace>
          <remove>-Element für <listeners> für <source>

<remove name="listenerName" />

Attribute und Elemente

In den folgenden Abschnitten werden Attribute und untergeordnete sowie ü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 Konfigurationsdatei, das von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.
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>