Elemento <clear> per <listeners> per <source>

Articolo
09/12/2008

Aggiornamento: novembre 2007

Cancella l'insieme Listeners per un'origine di analisi.

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

<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.
sources	Contiene le origini di analisi che danno inizio ai messaggi di analisi.
source	Specifica un'origine di analisi che dà inizio ai messaggi di analisi.
listeners	Specifica i listener per la raccolta, l'archiviazione e l'invio di messaggi.

Note

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

File di configurazione

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

Esempio

Nell'esempio riportato di seguito viene illustrato come utilizzare l'elemento <clear> prima degli elementi <add> per l'aggiunta dei listener console e textListener all'insieme Listeners per l'origine di analisi TraceSourceApp.

<configuration>
  <system.diagnostics>
    <sources>
       <source name="TraceSourceApp" switchName="sourceSwitch" 
         switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <clear/>
          <add name="console" 
            type="System.Diagnostics.ConsoleTraceListener"/>
          <add name="textListener"/>
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add name="textListener" 
        type="System.Diagnostics.TextWriterTraceListener" 
        initializeData="myListener.log"/>
    </sharedListeners>
    <switches>
      <add name="sourceSwitch" value="Warning"/>
    </switches>
  </system.diagnostics>
</configuration>