Elemento <remove> per <listeners> per <source>

Articolo
08/11/2011

Rimuove un listener dall'insieme Listeners per un'origine di traccia.

<remove name="listenerName" />

Attributi ed elementi

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

Attributi

Attributo	Descrizione
name	Attributo obbligatorio. Nome del listener da rimuovere dall'insieme Listeners.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Descrizione
configuration	Elemento radice in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.
system.diagnostics	Specifica listener di traccia per la raccolta, la memorizzazione e l'invio di messaggi, nonché il livello in cui viene impostata un'opzione di traccia.
sources	Contiene le origini di traccia che danno inizio ai messaggi di tracciatura.
source	Specifica un'origine di traccia che dà inizio ai messaggi di tracciatura.
listeners	Specifica i listener per la raccolta, l'archiviazione e l'invio di messaggi.

Note

L'elemento <remove> consente di rimuovere un listener specificato dall'insieme Listeners per un'origine di traccia.

È possibile rimuovere un elemento dall'insieme Listeners per un'origine di traccia a livello di codice chiamando il metodo Remove sulla proprietà Listeners dell'istanza di TraceSource.

È 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 <remove> prima dell'elemento <add> per l'aggiunta del listener console all'insieme Listeners per l'origine di traccia TraceSourceApp.

<configuration>
  <system.diagnostics>
    <sources>
      <source name="TraceSourceApp" switchName="sourceSwitch" 
         switchType="System.Diagnostics.SourceSwitch" >
         <listeners>
           <remove name="Default"/>
           <add name="console" 
             type="System.Diagnostics.ConsoleTraceListener" />
         </listeners>
      </source>
    </sources>
  </system.diagnostics>
</configuration>