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

Artikel
08/10/2011

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

<clear/>

Attribute und Elemente

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

Attribute

Keine.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

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