<add>Elemento para <listeners>para <fonte>

Adiciona um ouvinte para o Listeners coleção para uma fonte de rastreamento.

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

<add name="name" 
  type="TraceListenerClassName, 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 tipo nomes totalmente qualificados.
initializeData	Atributo opcional. A cadeia de caracteres passada para o construtor da classe especificada. A ConfigurationException é jogada se a classe não tem um construtor que leva uma seqüência de caracteres.
name	Atributo opcional. Especifica o nome do ouvinte.
traceOutputOptions	Atributo opcional. Especifica o TraceOutputOptions valor da propriedade para o ouvinte de rastreamento.
[atributos personalizados]	Atributos opcionais. Especifica o valor para atributos específicos do ouvinte identificado pelo GetSupportedAttributes método para esse ouvinte. Delimiter é um exemplo de um atributo extra exclusivo para o DelimitedListTraceListener classe.

Elementos filho

Elemento	Descrição
<filter>Elemento para <add>para <listeners>para <fonte>	Adiciona um filtro para um ouvinte no Listeners coleção para uma fonte de rastreamento.

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 os ouvintes de rastreamento que coletar, armazenar, e rota mensagens e o nível em que um comutador de rastreamento está definido.
sources	Contém fontes de rastreamento que iniciam a mensagens de rastreamento.
source	Especifica uma fonte de rastreamento que inicia a mensagens de rastreamento.
listeners	Especifica os ouvintes que coletam, armazenam e rotear mensagens.

Comentários

As classes de ouvinte fornecidas com o .NET estrutura derivam do TraceListener classe.

Se você não especificar o name atributo do ouvinte de rastreamento, o NamePropriedades do ouvinte de rastreamento padrão é uma seqüência de caracteres vazia (""). Se seu aplicativo tiver somente um ouvinte, você pode adicioná-la sem especificar um nome e você poderá removê-lo, especificando uma seqüência de caracteres vazia para o nome. No entanto, se seu aplicativo tiver mais de um ouvinte, você deve especificar um nome exclusivo para cada ouvinte de rastreamento, que permite identificar e gerenciar os ouvintes de rastreamento individuais no TraceSource.Listeners coleção.

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.

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"escrever rastreamento e depurar de saída no fluxo de erro padrão; defini-la como"false"para gravar no fluxo de saída padrão.
System.Diagnostics.DelimitedListTraceListener	O nome do arquivo o DelimitedListTraceListener grava.
System.Diagnostics.EventLogTraceListener	O 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.

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 <add> elementos para adicionar os ouvintes console e textListener para o Listeners coleção da fonte de rastreamento de TraceSourceApp. The textListener ouvinte grava a saída de rastreamento myListener.log arquivo.

<configuration>
  <system.diagnostics>
    <sources>
      <source name="TraceSourceApp" switchName="sourceSwitch" 
        switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <add name="console" 
            type="System.Diagnostics.ConsoleTraceListener"/>
          <add name="textListener"/>
          <remove name="Default"/>
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add name="textListener" 
        type="System.Diagnostics.TextWriterTraceListener" 
        initializeData="myListener.log"/>
    </sharedListeners>
    <switches>
      <add name="sourceSwitch" value="Warning"/>
    </switches>
  </system.diagnostics>
</configuration> 

Consulte também

Conceitos

Ouvintes de Rastrear

Referência

Rastreamento e esquema configurações Debug

TraceSource

TraceListener