<adicionar> elemento para <ouvintes> para <rastreamento>

  • Artigo

Adiciona um ouvinte à coleção Listeners.

<configuration>
  <system.diagnostics>
    <rastreamento>
      <ouvintes>
        <add>

Syntax

<add name="name"
     type="trace listener class name, Version, Culture, PublicKeyToken"  
     initializeData="data"/>

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo Descrição
tipo Atributo obrigatório.

Especifica o tipo do ouvinte. Use uma cadeia de caracteres que atenda aos requisitos especificados em Especificar nomes de tipo totalmente qualificados.
initializeData Atributo opcional.

A cadeia de caracteres passada para o construtor da classe especificada.
name Atributo opcional.

Especifica o nome do ouvinte.

Elementos filho

Elemento Descrição
<filter> Adiciona um filtro a um ouvinte na coleção Listeners de rastreamento.

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.
listeners Especifica um ouvinte que coleta, armazena e roteia mensagens. Os ouvintes direcionam a saída de rastreamento para um destino apropriado.
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 derivam do TraceListener.

Se você não especificar o name atributo do ouvinte de rastreamento, o Name ouvinte de rastreamento padrão será uma cadeia de caracteres vazia (""). Se o aplicativo tiver apenas um ouvinte, você poderá adicioná-lo sem especificar um nome e removê-lo especificando uma cadeia de caracteres vazia para o nome. No entanto, se o aplicativo tiver mais de um ouvinte, você deverá especificar nomes exclusivos para cada ouvinte de rastreamento, o que permite identificar e gerenciar ouvintes de rastreamento individuais dentro das coleções e Listeners das Listeners coleções.

Observação

Adicionar mais de um ouvinte de rastreamento do mesmo tipo e com o mesmo nome resultará em apenas um ouvinte de rastreamento desse tipo e nome sendo adicionado à coleção Listeners. No entanto, você poderá adicionar programaticamente vários ouvintes idênticos à coleção Listeners.

O valor do atributo initializeData depende do tipo de ouvinte que você cria. Nem todos os ouvintes de rastreamento exigem que você especifique initializeData.

Observação

Ao usar o atributo initializeData, você poderá receber o aviso do compilador "O atributo 'initializeData' não é declarado". Esse aviso ocorre porque as definições de configuração são validadas na classe base abstrata TraceListener, que não reconhecerá o atributoinitializeData. Normalmente, é possível ignorar esse aviso para implementações de ouvinte de rastreamento que possuem um construtor que recebe um parâmetro.

A tabela a seguir mostra os ouvintes de rastreamento incluídos no .NET Framework e descreve o valor de seus atributos initializeData.

Classe de ouvinte de rastreamento valor do atributo initializeData
System.Diagnostics.ConsoleTraceListener O valor useErrorStream do construtor ConsoleTraceListener. Defina o initializeData atributo como "true" para gravar rastreamento e depurar saída para Console.Error; "false" para gravar em Console.Out.
System.Diagnostics.DelimitedListTraceListener O nome do arquivo no qual o DelimitedListTraceListener é gravado.
System.Diagnostics.EventLogTraceListener O nome da origem de um log de eventos existente.
System.Diagnostics.EventSchemaTraceListener O nome do arquivo no qual o EventSchemaTraceListener é gravado.
System.Diagnostics.TextWriterTraceListener O nome do arquivo no qual o TextWriterTraceListener é gravado.
System.Diagnostics.XmlWriterTraceListener O nome do arquivo no qual o XmlWriterTraceListener é gravado.

Exemplo

O exemplo a seguir mostra como usar <a adição> de elementos para adicionar os ouvintes MyListener e MyEventListener à coleção Listeners. 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"/>  
            <add name="configConsoleListener"  
                 type="System.Diagnostics.ConsoleTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>  
         </listeners>  
      </trace>  
   </system.diagnostics>  
</configuration>

Confira também