Elemento <add> per <listeners> per <trace>

Articolo
09/12/2008

Aggiornamento: novembre 2007

Consente di aggiungere un listener all'insieme Listeners.

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

<add name="name" 
     type="trace listener class name, Version, Culture, PublicKeyToken"
     initializeData="data"/>

Attributi ed elementi

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

Attributi

Attributo	Descrizione
type	Attributo obbligatorio. Specifica il tipo del listener. È necessario utilizzare una stringa che soddisfi i requisiti indicati in Specifica di nomi di tipi completi.
initializeData	Attributo facoltativo. Stringa passata al costruttore per la classe specificata.
name	Attributo facoltativo. Specifica il nome del listener.

type

Attributo obbligatorio.

Specifica il tipo del listener. È necessario utilizzare una stringa che soddisfi i requisiti indicati in Specifica di nomi di tipi completi.

initializeData

Attributo facoltativo.

Stringa passata al costruttore per la classe specificata.

name

Attributo facoltativo.

Specifica il nome del listener.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Descrizione
configuration	Elemento di primo livello in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.
listeners	Specifica un listener per la raccolta, la memorizzazione e l'invio di messaggi. I listener indirizzano l'output di analisi a una destinazione adatta.
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 un oggetto listener all'insieme di una delle due classi, lo stesso listener verrà utilizzato anche dall'altra classe. Le classi di listener derivano dalla classe TraceListener.

Se non viene specificato l'attributo name del listener di analisi, l'impostazione predefinita della proprietà Name del listener di analisi sarà una stringa vuota (""). Se l'applicazione dispone di un solo listener, è possibile aggiungerlo senza specificarne il nome e rimuoverlo specificando per il nome una stringa vuota. Se invece l'applicazione dispone di più listener, è necessario specificare nomi univoci per ciascun listener di analisi, al fine di identificare e gestire singolarmente i listener di analisi negli insiemi Listeners e Listeners.

Nota

L'aggiunta di più listener di analisi dello stesso tipo e con lo stesso nome implica l'aggiunta di un solo listener di analisi di tale tipo e con tale nome all'insieme Listeners. È tuttavia possibile aggiungere a livello di codice più listener identici all'insieme Listeners.

Il valore dell'attributo initializeData dipende dal tipo di listener creato. Non per tutti i listener di analisi è necessario specificare l'attributo initializeData.

Nota

Quando si utilizza l'attributo initializeData, è possibile ottenere l'avviso del compilatore "Attributo 'initializeData' non dichiarato". Questo avviso viene generato perché le impostazioni di configurazione vengono convalidate in base alla classe di base astratta TraceListener che non riconosce l'attributo initializeData. In genere, è possibile ignorare questo avviso per implementazioni del listener di analisi che presentano un costruttore che accetta un parametro.

Nella tabella riportata di seguito vengono elencati i listener di analisi inclusi in .NET Framework e viene fornita una descrizione del valore dei relativi attributi initializeData.

Classe di listener di analisi	Valore dell'attributo initializeData
System.Diagnostics.ConsoleTraceListener	Valore useErrorStream del costruttore ConsoleTraceListener. Impostare l'attributo initializeData su "true" per scrivere l'output di analisi e debug in Console.Error, oppure su "false" per scrivere l'output in Console.Out.
System.Diagnostics.DelimitedListTraceListener	Nome del file in cui DelimitedListTraceListener esegue operazioni di scrittura.
System.Diagnostics.EventLogTraceListener	Nome di un'origine del log eventi esistente.
System.Diagnostics.EventSchemaTraceListener	Nome del file in cui EventSchemaTraceListener esegue operazioni di scrittura.
System.Diagnostics.TextWriterTraceListener	Nome del file in cui TextWriterTraceListener esegue operazioni di scrittura.
System.Diagnostics.XmlWriterTraceListener	Nome del file in cui XmlWriterTraceListener esegue operazioni di scrittura.

Esempio

Nell'esempio che segue viene illustrato l'utilizzo di elementi <add> 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"/>
            <add name="configConsoleListener"
                 type="System.Diagnostics.ConsoleTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
         </listeners>
      </trace>
   </system.diagnostics>
</configuration>