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

Articolo
09/12/2008

Aggiornamento: novembre 2007

Cancella l'insieme Listeners per l'analisi.

Elemento <Configuration>
  Elemento <system.diagnostics>
    Elemento <trace>
      Elemento <listeners> per <trace>
        Elemento <clear> per <listeners> per <trace>

<clear/>

Attributi ed elementi

Nelle sezioni riportate di seguito vengono illustrati attributi, elementi figlio e padre.

Attributi

Nessuno.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Descrizione
configuration	È l'elemento di primo livello 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 analisi.
trace	Contiene listener per la raccolta, la memorizzazione e l'invio di messaggi di analisi.
listeners	Contiene listener per la raccolta, l'archiviazione e l'invio di messaggi. I listener indirizzano l'output di analisi a una destinazione adatta.

Note

L'elemento <clear> consente di rimuovere tutti i listener dall'insieme Listeners per l'analisi. È 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 a un metodo Assert o Fail normalmente comporta la visualizzazione di una finestra di messaggio. La finestra di messaggio tuttavia non viene visualizzata se la classe DefaultTraceListener non è contenuta 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 l'analisi.

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