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

Articolo
08/11/2011

Consente di aggiungere un listener all'insieme Listeners.

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

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Attribute	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	Oggetto di descrizione
configuration	Elemento radice in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.
listeners	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.
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 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 traccia, l'impostazione predefinita della proprietà Name del listener di traccia 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 traccia, al fine di identificare e gestire singolarmente i listener di traccia negli insiemi Listeners e Listeners.

Nota
L'aggiunta di più listener di traccia dello stesso tipo e con lo stesso nome implica l'aggiunta di un solo listener di traccia 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 traccia è 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 traccia che presentano un costruttore che accetta un parametro.

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 traccia che presentano un costruttore che accetta un parametro.

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

Classe di listener di traccia	Valore dell'attributo initializeData
System.Diagnostics.ConsoleTraceListener	Valore useErrorStream del costruttore ConsoleTraceListener. Impostare l'attributo initializeData su "true" per scrivere l'output di traccia 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 riportato di seguito viene illustrato come utilizzare gli elementi <add> 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"/>
            <add name="configConsoleListener"
                 type="System.Diagnostics.ConsoleTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
         </listeners>
      </trace>
   </system.diagnostics>
</configuration>