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

Artikel
09/02/2008

Aktualisiert: November 2007

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

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

<clear/>

Attribute und Elemente

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

Attribute

Keine.

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 <clear>-Element entfernt alle Listener, einschließlich des DefaultTraceListener, aus der Listeners-Auflistung für eine Ablaufverfolgungsquelle. Verwenden Sie das <clear>-Element vor der Verwendung des <add>-Elements, um sicherzugehen, dass sich keine weiteren aktiven Listener in der Auflistung befinden.

Konfigurationsdatei

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

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie das <clear>-Element verwendet wird, bevor der Listeners-Auflistung für die Ablaufverfolgungsquelle TraceSourceApp mithilfe der <add>-Elemente die Listener console und textListener hinzugefügt werden.

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