<listeners> Elemento para <trace>

Artigo
08/01/2011

Especifica um ouvinte que coleta, armazena e encaminha as mensagens. Ouvintes de direcionam a saída de rastreamento para um destino apropriado.

<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> Elemento para <listeners> Para <trace>	Adiciona um ouvinte para o Listeners coleção.
<clear> Elemento para <listeners> Para <trace>	Limpa o Listeners coleção para rastreamento.
<remove> Elemento para <listeners> Para <trace>	Remove um ouvinte da Listeners coleção.

Elementos pai

Elemento	Descrição
configuration	O elemento raiz em cada arquivo de configuração usadas pelos common language runtime e .NET Framework aplicativos.
system.diagnostics	Especifica o elemento raiz para o ASP.Seção de configuração de rede.
trace	Contém os ouvintes que coletam, armazenam e roteiam mensagens de rastreamento.

Comentários

O Debug e Trace classes compartilharem os mesmos ouvintes coleção. Se você adicionar um objeto de ouvinte à coleção em uma dessas classes, a outra classe usa o mesmo ouvinte. As classes de ouvinte é fornecido com o.NET Framework derivam de TraceListener classe.

Arquivo de configuração

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

Exemplo

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

Consulte também

Referência

Rastreamento e esquema configurações Debug

TraceListener

Compartilhar via