<add> Elemento para <listeners> Para <trace>

Artigo
08/01/2011

Adiciona um ouvinte para o ouvintes coleção.

<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. Você deve usar uma seqüência de caracteres que atenda aos requisitos especificados em Especificando nomes de tipo totalmente qualificado.
initializeData	Atributo opcional. A seqüência passada para o construtor da classe especificada.
name	Atributo opcional. Especifica o nome do ouvinte.

tipo

Atributo obrigatório.

Especifica o tipo do ouvinte. Você deve usar uma seqüência de caracteres que atenda aos requisitos especificados em Especificando nomes de tipo totalmente qualificado.

initializeData

Atributo opcional.

A seqüência passada para o construtor da classe especificada.

name

Atributo opcional.

Especifica o nome do ouvinte.

Elementos filho

Nenhum.

Elementos pai

Elemento	Descrição
configuration	O elemento raiz em cada arquivo de configuração usadas pelos common language runtime e .NET Framework aplicativos.
listeners	Especifica um ouvinte que coleta, armazena e encaminha as mensagens. Ouvintes de direcionam a saída de rastreamento para um destino apropriado.
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 derivam de classe TraceListener.

Se você não especificar o namo ouvinte de rastreamento, atributo e o Name dos padrões de ouvinte de rastreamento para uma seqüência vazia (""). Se seu aplicativo tiver somente um ouvinte, você pode adicioná-la sem especificar um nome e removê-lo especificando uma seqüência vazia para o nome. No entanto, se seu aplicativo tiver mais de um ouvinte, você deve especificar nomes exclusivos para cada ouvinte de rastreamento, que lhe permite identificar e gerenciar os ouvintes de rastreamento individuais dentro de Listeners e Listeners coleções.

Observação

Adicionar mais de um ouvinte de rastreamento do mesmo tipo e com a mesma resulta no ouvinte de rastreamento de apenas um tipo de nome e nome que está sendo adicionado a Listeners coleção.No entanto, você pode programaticamente adicionar vários ouvintes idênticos para o Listeners coleção.

O valor para o initializeData atributo depende do tipo de ouvinte que você criar. Nem todos os ouvintes de rastreamento requerem que você especifique initializeData.

Observação

Quando você usa o initializeData atributo, você pode receber o aviso do compilador "'initializedata' atributo não está declarado". Este aviso ocorre porque as definições de configuração são validadas contra a classe base abstrata TraceListener, que não reconhece o initializeData atributo.Normalmente, você pode ignorar esse aviso para implementações de ouvinte de rastreamento tem um construtor que aceita um parâmetro.

A tabela a seguir mostra os ouvintes de rastreamento que estão incluídos com o.NET Framework e descreve o valor de suas initializeData atributos.

Classe do ouvinte de rastreamento.	valor do atributo initializeData
System.Diagnostics.ConsoleTraceListener	O useErrorStream valor para o ConsoleTraceListener construtor. Definir o initializeData para o atributo "true" para gravar o rastreamento e depuração de saída para Console.Error; "false" para gravar Console.Out.
System.Diagnostics.DelimitedListTraceListener	O nome do arquivo de DelimitedListTraceListener grava.
System.Diagnostics.EventLogTraceListener	O nome do nome de uma fonte de log de eventos existente.
System.Diagnostics.EventSchemaTraceListener	O nome do arquivo que o EventSchemaTraceListener grava.
System.Diagnostics.TextWriterTraceListener	O nome do arquivo que o TextWriterTraceListener grava.
System.Diagnostics.XmlWriterTraceListener	O nome do arquivo que o XmlWriterTraceListener grava.

Exemplo

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