<Elemento listeners> para <rastreamento>

  • Artigo

Especifica um ouvinte que coleta, armazena e roteia mensagens. Os ouvintes direcionam a saída de rastreamento para um destino apropriado.

<configuration>
  <system.diagnostics>
    <rastreamento>
      <listeners>

Syntax

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

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 Listeners.
<clear> Limpa a coleção Listeners do rastreamento.
<remove> Remove um ouvinte da coleção Listeners.

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.
trace Contém os ouvintes que coletam, armazenam e roteiam mensagens de rastreamento.

Comentários

As Debug classes e as Trace classes compartilham a mesma coleção Listeners. Se você adicionar um objeto ouvinte à coleção em uma dessas classes, a outra classe usará o mesmo ouvinte. As classes de ouvinte enviadas com o .NET Framework derivam da classe TraceListener.

Arquivo de configuração

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

Exemplo

O exemplo a seguir mostra como usar o <elemento ouvintes> para adicionar os ouvintes MyListener e MyEventListener a coleção Ouvintes. MyListener cria um arquivo chamado MyListener.log e grava a saída no arquivo. MyEventListener cria uma entrada no log 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>

Confira também