Elemento <add> per <sharedListeners>

Articolo
08/11/2011

Consente di aggiungere un listener all'insieme sharedListeners. sharedListeners è un insieme di listener cui può fare riferimento qualsiasi elemento Elemento <source> o Elemento <trace>. Per impostazione predefinita, i listener dell'insieme sharedListeners non vengono inseriti in un insieme Listeners, ma devono essere aggiunti per nome all'Elemento <source> o all'Elemento <trace>. Non è possibile ottenere i listener nell'insieme sharedListeners nel codice in fase di esecuzione.

<add name="name" 
  type="TraceListenerClassName, Version, Culture, PublicKeyToken"
  initializeData="data"/>

Attributi ed elementi

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

Attributi

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

name

Attributo obbligatorio.

Specifica il nome del listener utilizzato per aggiungere il listener condiviso a un insieme Listeners.

type

Attributo obbligatorio.

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

initializeData

Attributo facoltativo.

Stringa passata al costruttore per la classe specificata.

Elementi figlio

Elemento	Oggetto di descrizione
Elemento <filter> per <add> per <sharedListeners>	Consente di aggiungere un filtro a un listener dell'insieme sharedListeners.

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 listener di traccia per la raccolta, la memorizzazione e l'invio di messaggi, nonché il livello in cui viene impostata un'opzione di traccia.
sharedListeners	Insieme di listener cui può fare riferimento qualsiasi elemento di origine o di traccia.

Note

Le classi di listener fornite con .NET Framework derivano dalla classe TraceListener. Il valore dell'attributo name viene utilizzato per aggiungere il listener condiviso a un insieme Listeners per una traccia o un'origine di traccia. 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
ConsoleTraceListener	Valore useErrorStream del costruttore ConsoleTraceListener. Impostare l'attributo initializeData su true per scrivere l'output di traccia e di debug nel flusso di errori standard. Impostarlo invece su false per scrivere nel flusso di output standard.
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.
XmlWriterTraceListener	Nome del file in cui XmlWriterTraceListener esegue operazioni di scrittura.

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 gli elementi <add> per aggiungere TextWriterTraceListener textListener all'insieme sharedListeners. textListener viene aggiunto per nome all'insieme Listeners per l'origine di traccia TraceSourceApp. Il listener textListener scrive l'output di traccia nel file myListener.log.

<configuration>
  <system.diagnostics>
    <sources>
      <source name="TraceSourceApp" switchName="sourceSwitch" 
        switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <add name="console" 
            type="System.Diagnostics.ConsoleTraceListener"/>
          <add name="textListener"/>
          <remove name="Default"/>
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add name="textListener" 
        type="System.Diagnostics.TextWriterTraceListener" 
        initializeData="myListener.log"/>
    </sharedListeners>
    <switches>
      <add name="sourceSwitch" value="Warning"/>
    </switches>
  </system.diagnostics>
</configuration>