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

Artikel
05/10/2023

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

<configuration>
  <system.diagnostics>
    <trace>
      <listeners>
        <clear>

Syntax

<clear/>

Attribute und Elemente

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

Attribute

Keine

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Element	BESCHREIBUNG
`configuration`	Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.
`system.diagnostics`	Gibt Ablaufverfolgungslistener an, die Meldungen sammeln, speichern und weiterleiten sowie die Ebene, für die ein Ablaufverfolgungsschalter festgelegt ist.
`trace`	Enthält Listener, die Ablaufverfolgungsmeldungen sammeln, speichern und weiterleiten.
`listeners`	Enthält Listener, die Meldungen sammeln, speichern und weiterleiten. Listener leiten die Überwachungsausgabe an ein geeignetes Ziel weiter.

Bemerkungen

Das <clear>-Element entfernt alle Listener aus der Listeners-Auflistung für die Überwachung. Sie können das <clear>-Element vor dem <add>-Element verwenden, um sicherzustellen, dass keine anderen aktiven Listener in der Auflistung vorhanden sind.

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 den DefaultTraceListener aus der Listeners-Auflistung und ändert das Verhalten der Methoden Debug.Assert, Trace.Assert, Debug.Fail und Trace.Fail. Das Aufrufen der Methode Assert oder Fail führt normalerweise zur Anzeige eines Meldungsfelds. Das Meldungsfeld wird jedoch nicht angezeigt, wenn der DefaultTraceListener nicht in der Listeners-Auflistung enthalten ist.

Beispiel

Das folgende Beispiel zeigt, wie Sie das <clear>-Element vor dem <add>-Element verwenden, um den Listener console der Listeners-Auflistung für die Überwachung hinzuzufügen.

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