Condividi tramite


Elemento <add> per <sharedListeners>

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.

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> 

Vedere anche

Concetti

Listener di analisi

Riferimenti

Schema delle impostazioni di analisi e debug

TraceSource

TraceListener