<elemento de serviços de escuta> para <origem>

Artigo
05/10/2023

Adiciona ou remove serviços de escuta na Listeners coleção de um TraceSource. Um serviço de escuta direciona a saída de rastreio para um destino adequado, como um ficheiro de registo, janela ou texto.

<configuração>
  <system.diagnostics>
    <origens>
      <origem>
        <serviços de escuta>

Syntax

<listeners>
  <add>...</add>  
  <remove ... />  
  <clear/>  
</listeners>

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 à `Listeners` coleção.
<remover>	Remove um serviço de escuta da `Listeners` coleção.
<limpar>	Limpa a coleção de uma origem `Listeners` de rastreio.

Elementos Principais

Elemento	Descrição
`configuration`	O elemento raiz em todos os ficheiros de configuração utilizados pelo runtime de idioma comum e .NET Framework aplicações.
`system.diagnostics`	Especifica serviços de escuta de rastreio que recolhem, armazenam e encaminham mensagens e o nível em que um comutador de rastreio está definido.
`sources`	Contém origens de rastreio que iniciam mensagens de rastreio.
`source`	Especifica uma origem de rastreio que inicia mensagens de rastreio.

Observações

Ficheiro de Configuração

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 <listeners> elemento para adicionar um serviço de escuta de rastreio da consola à origem mySource e remover o serviço de escuta de rastreio predefinido.

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="mySource" switchName="sourceSwitch"
        switchType="System.Diagnostics.SourceSwitch">  
        <listeners>  
          <add name="console"
            type="System.Diagnostics.ConsoleTraceListener">  
            <filter type="System.Diagnostics.EventTypeFilter"
              initializeData="Error"/>  
          </add>  
          <remove name="Default"/>  
        </listeners>  
      </source>  
    </sources>  
    <switches>  
      <add name="sourceSwitch" value="Warning"/>  
    </switches>  
  </system.diagnostics>  
</configuration>

Partilhar via