Elemento <sharedListeners>

  • Artigo

Contém os ouvintes que podem ser referenciados por qualquer elemento de origem ou de rastreamento. Esses ouvintes não recebem rastreamentos por padrão e não é possível recuperar esses ouvintes em tempo de execução. Ouvintes identificados como ouvintes compartilhados podem ser adicionados a fontes ou rastreamentos por nome.

<configuration>
  <system.diagnostics>
    <sharedListeners>

Syntax

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

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Nenhum.

Elementos filho

Elemento Descrição
<add> Adiciona um ouvinte na coleção sharedListeners.

Elementos pai

Elemento Descrição
Configuration O elemento raiz em cada arquivo de configuração usado pelos aplicativos do Common Language Runtime e .NET Framework.
system.diagnostics Especifica o elemento raiz da seção de configuração do ASP.NET.

Comentários

Adicionar um ouvinte à coleção de ouvintes compartilhados não o torna um ouvinte ativo. Ele ainda deve ser adicionado a uma fonte de rastreamento ou um rastreamento adicionando-o à coleção Listeners desse elemento de rastreamento. As classes de ouvinte na .NET Framework derivam da classe TraceListener.

Esse elemento pode ser usado no arquivo de configuração de computador (Machine.config) e no arquivo de configuração de aplicativo.

Exemplo

O exemplo a seguir mostra como usar o <sharedListeners> elemento para adicionar o ouvinte console à Listeners coleção para as classes TraceSource e Trace. O ouvinte de rastreamento do console grava informações de rastreamento no console por meio de chamadas para TraceSource ou 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>

Confira também