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

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

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

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

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>