<elemento clear> per i listener> per <<la traccia>

Cancella la raccolta Listeners per una traccia.

<Configurazione>
  <system.diagnostics>
    <Traccia>
      <Ascoltatori>
        <Chiaro>

Sintassi

<clear/>  

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Nessuno.

Elementi figlio

Nessuno.

Elementi padre

Elemento Descrizione
configuration Elemento radice in ciascun file di configurazione usato in Common Language Runtime e nelle applicazioni .NET Framework.
system.diagnostics Specifica i listener di traccia per raccogliere, archiviare e indirizzare i messaggi, oltre al livello di impostazione di un'opzione di traccia.
trace Contiene i listener che raccolgono, archiviano e indirizzano i messaggi di traccia.
listeners Contiene listener che raccolgono, archivia e instradano i messaggi. I listener indirizzano l'output della traccia a una destinazione appropriata.

Commenti

L'elemento <clear> rimuove tutti i listener dalla raccolta per la Listeners traccia. È possibile usare l'elemento prima di usare l'elemento <clear><add> per essere certi che non siano presenti altri listener attivi nella raccolta.

È possibile cancellare la raccolta a livello di codice chiamando il ListenersClear metodo nella Trace.Listeners proprietà (System.Diagnostics.Trace.Listeners.Clear()).

Questo elemento può essere usato nel file di configurazione del computer (Machine.config) e nel file di configurazione dell'applicazione.

Nota

L'elemento <clear> rimuove l'oggetto DefaultTraceListener dall'insieme Listeners , modificando il comportamento dei Debug.Assertmetodi , Trace.Assert, Debug.Faile Trace.Fail . La chiamata di un Assert metodo o Fail comporta normalmente la visualizzazione di una finestra di messaggio. Tuttavia, la finestra di messaggio non viene visualizzata se l'oggetto DefaultTraceListener non è presente nella Listeners raccolta.

Esempio

Nell'esempio seguente viene illustrato come usare l'elemento <clear> prima di usare l'elemento <add> per aggiungere il listener console alla raccolta per la Listeners traccia.

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

Vedi anche