Elemento <add> per <sharedListeners>

Articolo
09/12/2008

Aggiornamento: novembre 2007

Consente di aggiungere un listener all'insieme sharedListeners. sharedListeners è un insieme di listener cui può fare riferimento qualsiasi 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.

Elemento <Configuration>
  Elemento <system.diagnostics>
    Elemento <sharedListeners>
      Elemento <add> per <listeners> per <source>

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

Attributi ed elementi

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

Attributi

Attributo	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	Descrizione
Elemento <filter> per <add> per <sharedListeners>	Consente di aggiungere un filtro a un listener all'insieme sharedListeners.

Elementi padre

Elemento	Descrizione
configuration	Elemento principale in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.
system.diagnostics	Consente di specificare listener di analisi per la raccolta, la memorizzazione e l'invio di messaggi, nonché il livello in cui viene impostata un'opzione di analisi.
sharedListeners	Insieme di listener cui può fare riferimento qualsiasi elemento di origine o di analisi.

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 un'analisi o un'origine di analisi. 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
ConsoleTraceListener	Valore useErrorStream del costruttore ConsoleTraceListener. Impostare l'attributo initializeData su "true" per scrivere l'output di analisi 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 elementi <add> per aggiungere il listener textListenerTextWriterTraceListener all'insieme sharedListeners. textListener viene aggiunto per nome all'insieme Listeners per l'origine di analisi TraceSourceApp. Il listener textListener scrive l'output di analisi 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>