<sharedListeners Element (Elemento sharedListeners> )

Artigo
05/10/2023

Contém serviços de escuta que qualquer elemento de origem ou rastreio pode referenciar. Estes serviços de escuta não recebem quaisquer rastreios por predefinição e não é possível obter estes serviços de escuta no tempo de execução. Os serviços de escuta identificados como serviços de escuta partilhados podem ser adicionados a origens ou rastreios por nome.

<configuração>
<system.diagnostics>
<sharedListeners>

Syntax

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

Atributos e Elementos

As secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Nenhum.

Elementos Subordinados

Elemento	Descrição
<adicionar>	Adiciona um serviço de escuta à `sharedListeners` coleção.

Elementos Principais

Elemento	Descrição
`Configuration`	O elemento raiz em cada ficheiro de configuração utilizado pelo runtime de linguagem comum e .NET Framework aplicações.
`system.diagnostics`	Especifica o elemento raiz para a secção de configuração ASP.NET.

Observações

Adicionar um serviço de escuta à coleção de serviços de escuta partilhados não o torna um serviço de escuta ativo. Ainda tem de ser adicionado a uma origem de rastreio ou a um rastreio ao adicioná-lo à Listeners coleção para esse elemento de rastreio. As aulas de serviço de escuta na .NET Framework derivam da TraceListener turma.

Este elemento pode ser utilizado no ficheiro de configuração do computador (Machine.config) e no ficheiro de configuração da aplicação.

Exemplo

O exemplo seguinte mostra como utilizar o <sharedListeners> elemento para adicionar o serviço de escuta console à Listeners coleção para as TraceSource classes e Trace . O serviço de escuta de rastreio da consola escreve informações de rastreio na consola através 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>

Partilhar via