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

Artigo
05/10/2023

Especifica um serviço de escuta que recolhe, armazena e encaminha mensagens. Os serviços de escuta direcionam a saída de rastreio para um destino adequado.

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

Syntax

<listeners>
  <add>...</add>  
  <clear/>  
  <remove ... />  
</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.
<limpar>	Limpa a `Listeners` coleção para rastreio.
<remover>	Remove um serviço de escuta da `Listeners` 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.
`trace`	Contém serviços de escuta que recolhem, armazenam e encaminham mensagens de rastreio.

Observações

As Debug classes e Trace partilham a mesma coleção de Serviços de Escuta . Se adicionar um objeto de serviço de escuta à coleção numa destas classes, a outra classe utiliza o mesmo serviço de escuta. As classes de serviço de escuta enviadas com o .NET Framework derivam da TraceListener turma.

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 <elemento de serviços de> escuta para adicionar os serviços de escuta MyListener e MyEventListener à coleção Serviços de Escuta. MyListener cria um ficheiro chamado MyListener.log e escreve a saída no ficheiro. MyEventListener cria uma entrada no registo de eventos.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="true" indentsize="0">  
      <listeners>  
        <add name="myListener"
          type="System.Diagnostics.TextWriterTraceListener,
            system, version=1.0.3300.0, Culture=neutral,
            PublicKeyToken=b77a5c561934e089"
          initializeData="c:\myListener.log" />  
        <add name="MyEventListener"  
          type="System.Diagnostics.EventLogTraceListener,
            system, version=1.0.3300.0, Culture=neutral,
            PublicKeyToken=b77a5c561934e089"  
          initializeData="MyConfigEventLog"/>  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>

Partilhar via