Elemento <listeners> per <source>

Articolo
09/12/2008

Aggiornamento: novembre 2007

Consente di aggiungere o rimuovere listener nell'insieme Listeners per un oggetto TraceSource. I listener indirizzano l'output di analisi a una destinazione appropriata, ad esempio un file di log, una finestra o un file di testo.

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

<listeners> 
  <add>...</add>
  <remove ... />
  <clear/>
</listeners>

Attributi ed elementi

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

Attributi

Nessuno.

Elementi figlio

Elemento	Descrizione
Elemento <add> per <listeners> per <source>	Consente di aggiungere un listener all'insieme Listeners.
Elemento <remove> per <listeners> per <source>	Consente di rimuovere un listener dall'insieme Listeners.
Elemento <clear> per <listeners> per <source>	Cancella l'insieme Listeners per un'origine di analisi.

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.

Note

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 l'utilizzo dell'elemento <listeners> per aggiungere il listener di analisi di console all'origine mySource e per rimuovere il listener di analisi predefinito.

<configuration>
  <system.diagnostics>
    <sources>
      <source name="mySource" switchName="sourceSwitch" 
        switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <add name="console" 
            type="System.Diagnostics.ConsoleTraceListener">
            <filter type="System.Diagnostics.EventTypeFilter" 
              initializeData="Error"/>
          </add>
          <remove name="Default"/>
        </listeners>
      </source>
    </sources>
    <switches>
      <add name="sourceSwitch" value="Warning"/>
    </switches>
  </system.diagnostics>
</configuration>

Vedere anche

Concetti

Listener di analisi

Riferimenti

Schema delle impostazioni di analisi e debug

TraceListener

Condividi tramite