Elemento <listeners> per <trace>

Articolo
09/12/2008

Aggiornamento: novembre 2007

Consente di specificare un listener per la raccolta, la memorizzazione e l'invio di messaggi. I listener indirizzano l'output di analisi a una destinazione adatta.

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

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

Attributi ed elementi

Le seguenti sezioni illustrano attributi, elementi figlio e padre.

Attributi

Nessuno.

Elementi figlio

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

Elementi padre

Elemento	Descrizione
configuration	Elemento principale in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.
system.diagnostics	Specifica l'elemento principale per la sezione di configurazione ASP.NET.
trace	Contiene listener per la raccolta, la memorizzazione e l'invio di messaggi di analisi.

Note

Le classi Debug e Trace condividono lo stesso insieme Listeners. Se si aggiunge, pertanto, un oggetto listener all'insieme di una delle due classi, anche l'altra utilizzerà lo stesso listener. Le classi di listener fornite con .NET Framework derivano dalla classe TraceListener.

File di configurazione

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

Esempio

Nell'esempio che segue viene illustrato l'utilizzo dell'elemento <listeners> per aggiungere i listener MyListener e MyEventListener all'insieme Listeners. MyListener consente di creare un file denominato MyListener.log in cui scrivere l'output. MyEventListener crea una voce nel log eventi.

<configuration>
  <system.diagnostics>
    <trace autoflush="true" indentsize="0">
      <listeners>
        <add name="myListener" 
          type="System.Diagnostics.TextWriterTraceListener, 
            system, version=1.0.3300.0, Culture=neutral, 
            PublicKeyToken=b77a5c561934e089" 
          initializeData="c:\myListener.log" />
        <add name="MyEventListener"
          type="System.Diagnostics.EventLogTraceListener, 
            system, version=1.0.3300.0, Culture=neutral, 
            PublicKeyToken=b77a5c561934e089"
          initializeData="MyConfigEventLog"/>
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>

Vedere anche

Riferimenti

Schema delle impostazioni di analisi e debug

TraceListener

Condividi tramite