Elemento <listeners> per <trace>

Articolo
08/11/2011

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

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

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati 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 la traccia.
Elemento <remove> per <listeners> per <trace>	Consente di rimuovere un listener dall'insieme Listeners.

Elementi padre

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

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 riportato di seguito viene illustrato come utilizzare l'elemento <listeners> per aggiungere i listener MyListener e MyEventListener all'insieme Listeners. MyListener crea un file denominato MyListener.log e scrive l'output al suo interno. MyEventListenercrea 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 traccia e debug

TraceListener

Condividi tramite