Elemento <sharedListeners>

Articolo
08/11/2011

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

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

Attributi ed elementi

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

Attributi

Nessuno.

Elementi figlio

Elemento	Oggetto di descrizione
Elemento <add> per <listeners> per <trace>	Consente di aggiungere un listener all'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 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 traccia o a una traccia, ovvero inserito nell'insieme Listeners per tale elemento di traccia. 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 traccia di console scrive le informazioni sulla traccia sulla console mediante chiamate a TraceSource o a Trace.

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

Vedere anche

Riferimenti

Schema delle impostazioni di traccia e debug

TraceListener

Concetti

Listener di traccia

Condividi tramite