Elemento <clear> per <listeners> per <trace>

Articolo
08/11/2011

Cancella l'insieme Listeners per la traccia.

<clear/>

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Nessuno.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Oggetto di descrizione
configuration	Elemento radice in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.
system.diagnostics	Specifica listener di analisi per la raccolta, la memorizzazione e l'invio di messaggi, nonché il livello in cui viene impostata un'opzione di traccia.
trace	Contiene listener per la raccolta, la memorizzazione e l'invio di messaggi di tracciatura.
listeners	Contiene listener per la raccolta, l'archiviazione e l'invio di messaggi. I listener indirizzano l'output di tracciatura a una destinazione adatta.

Note

L'elemento <clear> consente di rimuovere tutti i listener dall'insieme Listeners per la traccia. È possibile utilizzare l'elemento <clear> prima dell'elemento <add> per essere certi che nell'insieme non vi siano altri listener attivi.

È possibile cancellare l'insieme Listeners a livello di codice chiamando il metodo Clear sulla proprietà Trace.Listeners (System.Diagnostics.Trace.Listeners.Clear()).

È possibile utilizzare questo elemento nei file di configurazione del computer (Machine.config) e dell'applicazione.

Nota
L'elemento <clear> rimuove la classe DefaultTraceListener dall'insieme Listeners modificando il comportamento dei metodi Debug.Assert, Trace.Assert, Debug.Fail e Trace.Fail.La chiamata di un metodo Assert o Fail comporta generalmente la visualizzazione di una finestra di messaggio.La finestra di messaggio non viene tuttavia visualizzata se DefaultTraceListener non è incluso nell'insieme Listeners.

L'elemento <clear> rimuove la classe DefaultTraceListener dall'insieme Listeners modificando il comportamento dei metodi Debug.Assert, Trace.Assert, Debug.Fail e Trace.Fail.La chiamata di un metodo Assert o Fail comporta generalmente la visualizzazione di una finestra di messaggio.La finestra di messaggio non viene tuttavia visualizzata se DefaultTraceListener non è incluso nell'insieme Listeners.

Esempio

Nell'esempio riportato di seguito viene illustrato come utilizzare l'elemento <clear> prima dell'elemento <add> per l'aggiunta del listener console all'insieme Listeners per la 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>