<add> Elemento para <listeners> Para <source>

Artigo
08/01/2011

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

<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 de caracteres que atenda aos requisitos especificados em Especificando tipo nomes totalmente qualificados.
initializeData	Atributo opcional. A seqüência passada para o construtor da classe especificada. A ConfigurationException é lançada 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 o valor da propriedade para o ouvinte de rastreamento.
[atributos personalizados]	Atributos opcionais. Especifica o valor para os atributos específicos do ouvinte, identificado pela GetSupportedAttributes método de 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 <source>	Adiciona um filtro para um ouvinte no Listeners coleção para uma origem de rastreamento.

Elementos pai

Elemento	Descrição
configuration	O elemento raiz em cada arquivo de configuração usadas pelos common language runtime e .NET Framework aplicativos.
system.diagnostics	Especifica os ouvintes de rastreamento que coletam, armazenam e roteiam mensagens e o nível em que um switch de rastreamento está definido.
sources	Contém fontes de rastreamento que iniciam mensagens de rastreamento.
source	Especifica uma origem de rastreamento que inicia as mensagens de rastreamento.
listeners	Especifica os ouvintes que coletam, armazenam e roteiam mensagens.

Comentários

As classes de ouvinte é fornecido com o.NET Framework derivam de TraceListener classe.

Se você não especificar o name atributo do ouvinte de rastreamento, o Name padrões de propriedade do ouvinte de rastreamento para uma seqüência 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 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 lhe permite identificar e gerenciar os ouvintes de rastreamento individuais na TraceSource.Listeners coleção.

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 o fluxo de erro padrão; Defina-o como "false" para gravar no fluxo de saída padrão.
System.Diagnostics.DelimitedListTraceListener	O nome do arquivo de 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 de máquina (Machine. config) e o arquivo de configuração do aplicativo.

Exemplo

O exemplo a seguir mostra como usar <add> para os ouvintes de adicionar elementos de console e textListener para o Listeners coleção origem de rastreamento de TraceSourceApp. O textListener ouvinte grava a saída de rastreamento para o arquivo myListener.log.

<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>