Elemento <listeners>para <trace>

Artigo
08/25/2010

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

<configuration> Element
  elemento <sistema.Diagnóstico>
    Elemento <trace>
      Elemento <listeners>para <trace>

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

Elementos pai

Elemento	Descrição
configuration	O elemento raiz em cada arquivo de configuração usado pelo Common linguagem tempo de execução e aplicativos do .NET estrutura.
system.diagnostics	Especifica o elemento raiz referente à seção de configuração do ASP.NET.
trace	Contém os ouvintes que coletam, armazenam e encaminhar mensagens de rastreamento.

Comentários

The Debug e Trace classes compartilham o mesmo Ouvintes coleção. Se você adicionar um objeto de ouvinte à coleção em uma dessas classes, a Outros classe usa o mesmo ouvinte. As classes de ouvinte fornecidas com o .NET estrutura derivam do TraceListener classe.

Arquivo de configuração

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

Exemplo

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

Consulte também

Referência

Rastreamento e esquema configurações Debug

TraceListener

Partilhar via