<Elemento listener> per <la traccia>

  • Articolo

Specifica un listener che raccoglie, archivia e instrada i messaggi. I listener indirizzano l'output della traccia a una destinazione appropriata.

<Configurazione>
  <system.diagnostics>
    <Traccia>
      <Ascoltatori>

Sintassi

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

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Nessuno.

Elementi figlio

Elemento Descrizione
<add> Aggiunge un listener alla raccolta Listeners.
<Chiaro> Cancella la raccolta Listeners per una traccia.
<Rimuovere> Rimuove un listener dalla Listeners raccolta.

Elementi padre

Elemento Descrizione
configuration Elemento radice in ciascun file di configurazione usato in Common Language Runtime e nelle applicazioni .NET Framework.
system.diagnostics Consente di specificare l'elemento radice per la sezione di configurazione ASP.NET.
trace Contiene i listener che raccolgono, archiviano e indirizzano i messaggi di traccia.

Commenti

Le Debug classi e Trace condividono la stessa raccolta Listener . Se si aggiunge un oggetto listener all'insieme in una di queste classi, l'altra classe usa lo stesso listener. Le classi listener fornite con .NET Framework derivano dalla TraceListener classe .

File di configurazione

Questo elemento può essere usato nel file di configurazione del computer (Machine.config) e nel file di configurazione dell'applicazione.

Esempio

Nell'esempio seguente viene illustrato come usare l'elemento <listener per aggiungere i listener e all'insieme Listener>MyListener.MyEventListener MyListener crea un file denominato MyListener.log e scrive l'output nel file. MyEventListener crea una voce nel registro 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>

Vedi anche