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

Artigo
08/25/2010

Adiciona um ouvinte para o Ouvintes coleção.

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

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

type

Atributo obrigatório.

Especifica o tipo do ouvinte. Você deve usar uma seqüência que atenda aos requisitos especificados em Especificando nomes de tipos 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

Nenhum.

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.
listeners	Especifica um ouvinte que coleta, lojas e encaminha mensagens. Ouvintes de direcionar a saída de rastreamento para um destino apropriado.
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 derivam do Classe TraceListener.

Se você não especificar o namatributo e do ouvinte de rastreamento, o Nameos padrões de ouvinte de rastreamento como uma seqüência de caracteres vazia (""). Se seu aplicativo tiver somente um ouvinte, você pode adicioná-la sem especificar um nome e removê-la, especificando uma seqüência de caracteres 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 permite identificar e gerenciar os ouvintes de rastreamento individuais dentro de Listeners e Listeners coleções.

Observação:
Adição de mais de escuta de um rastreamento do mesmo tipo e com os mesmos resultados no ouvinte de rastreamento somente um nome do tipo e nome que está sendo adicionado à Listeners coleção. No entanto, você pode programaticamente adicionar vários ouvintes idênticos à 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 initializeDataatributo, você pode obter o compilador de aviso "O atributo 'initializeData' não está declarado." Este aviso ocorre porque as definições de configuração são validadas em relação 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 que tem um construtor que aceita um parâmetro.

Quando você usa o initializeDataatributo, você pode obter o compilador de aviso "O atributo 'initializeData' não está declarado." Este aviso ocorre porque as definições de configuração são validadas em relação 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 que tem um construtor que aceita um parâmetro.

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

Classe do ouvinte de rastreamento	valor do atributo initializeData
System.Diagnostics.ConsoleTraceListener	The useErrorStream valor para o ConsoleTraceListener construtor. conjunto o initializeDataatributo como"true"para gravar o rastreamento e depurar saída para Console.Error; "false"para gravar Console.Out.
System.Diagnostics.DelimitedListTraceListener	O nome do arquivo o DelimitedListTraceListener grava.
System.Diagnostics.EventLogTraceListener	O nome do nome de uma fonte de registro 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> elementos 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"/>
            <add name="configConsoleListener"
                 type="System.Diagnostics.ConsoleTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
         </listeners>
      </trace>
   </system.diagnostics>
</configuration>