Elemento <sharedListeners>

Articolo
09/12/2008

Aggiornamento: novembre 2007

Contiene i listener cui può fare riferimento qualsiasi elemento di origine o di analisi. Per impostazione predefinita, questi listener non ricevono alcuna analisi e non possono essere recuperati in fase di esecuzione. I listener identificati come condivisi possono essere aggiunti alle origini o alle analisi in base al nome.

Elemento <Configuration>
Elemento <system.diagnostics>
Elemento <sharedListeners>

<sharedListeners> 
  <add>...</add>
</sharedListeners>

Attributi ed elementi

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

Attributi

Nessuno.

Elementi figlio

Elemento	Descrizione
Elemento <add> per <listeners> per <trace>	Consente di aggiungere un listener all'insieme sharedListeners.

Elementi padre

Elemento	Descrizione
Configuration	È l'elemento di primo livello in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.
system.diagnostics	Specifica l'elemento radice per la sezione di configurazione ASP.NET.

Note

Un listener aggiunto all'insieme dei listener condivisi non diventa automaticamente attivo. Deve infatti essere ancora aggiunto a un'origine di analisi o a un'analisi, ovvero inserito nell'insieme Listeners per tale elemento di analisi. Le classi di listener in .NET Framework derivano dalla classe TraceListener.

È 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 l'elemento <sharedListeners> per aggiungere il listener console all'insieme Listeners per le classi TraceSource e Trace. Il listener di analisi di console scrive le informazioni sulla traccia sulla console mediante chiamate a TraceSource o a Trace.

<system.diagnostics>
  <sources>
    <source name="mySource" switchName="sourceSwitch value="Verbose" >
      <listeners>
        <add name="console" />
      </listeners>
    </source>
  </sources>  
  <sharedListeners>    <add name="console" type="System.Diagnostics.ConsoleTraceListener" >      <filter type="System.Diagnostics.EventTypeFilter"         initializeData="Warning" />    </add>  </sharedListeners>
  <trace>
    <listeners>
      <add name="console" />
    </listeners>
  </trace>
</system.diagnostics>

Vedere anche

Concetti

Listener di analisi

Riferimenti

Schema delle impostazioni di analisi e debug

TraceListener

Condividi tramite