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

Artikel
08/20/2008

Aktualisiert: November 2007

Löscht die Listeners-Auflistung für die Ablaufverfolgung.

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

<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.
trace	Enthält Listener, die Verfolgungsmeldungen sammeln, speichern und weiterleiten.
listeners	Enthält Listener, die Meldungen sammeln, speichern und weiterleiten. Listener leiten die Ablaufverfolgungsausgabe an ein entsprechendes Ziel.

Hinweise

Das <clear>-Element entfernt alle Listener aus der Listeners-Auflistung für die Ablaufverfolgung. Verwenden Sie das <clear>-Element vor der Verwendung des <add>-Elements, um sicherzugehen, dass sich keine weiteren aktiven Listener in der Auflistung befinden.

Sie können die Listeners-Auflistung programmgesteuert löschen, indem Sie die Clear-Methode für die Trace.Listeners-Eigenschaft (System.Diagnostics.Trace.Listeners.Clear()) aufrufen.

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

Tipp

Das <clear>-Element entfernt DefaultTraceListener aus der Listeners-Auflistung und verändert damit das Verhalten folgender Methoden: Debug.Assert, Trace.Assert, Debug.Fail und Trace.Fail. Das Aufrufen der Assert-Methode oder der Fail-Methode führt normalerweise zur Anzeige eines Meldungsfelds. Aber das Meldungsfeld wird nicht angezeigt, wenn DefaultTraceListener nicht in der Listeners-Auflistung enthalten ist.

Beispiel

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

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="4">
      <listeners>
        </clear>
        <add name="console" 
          type="System.Diagnostics.ConsoleTraceListener" >
          <filter type="System.Diagnostics.EventTypeFilter" 
            initializeData="Error" />
        </add>
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>