<add> Elemento para <sharedListeners>

Artigo
08/01/2011

Adiciona um ouvinte para o sharedListeners coleção. sharedListenersé uma coleção de ouvintes de que qualquer <source> Elemento ou <trace> Elemento pode referência. Por padrão, os ouvintes na sharedListeners coleção não são colocados em um Listeners coleção. Eles devem ser adicionados por nome para o <source> Elemento ou <trace> Elemento. Não é possível obter os ouvintes de sharedListeners a coleção no código em tempo de execução.

<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
name	Atributo obrigatório. Especifica o nome do ouvinte que é usado para adicionar o ouvinte compartilhado para um Listeners coleçã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.

name

Atributo obrigatório.

Especifica o nome do ouvinte que é usado para adicionar o ouvinte compartilhado para um Listeners coleçã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.

Elementos filho

Elemento	Descrição
<filter> Elemento para <add> Para <sharedListeners>	Adiciona um filtro para um ouvinte no sharedListeners coleção.

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.
sharedListeners	Uma coleção de ouvintes de qualquer origem ou um elemento de rastreamento pode fazer referência.

Comentários

As classes de ouvinte é fornecido com o.NET Framework derivam de TraceListener classe. O valor para o name atributo é usado para adicionar o ouvinte compartilhado para um Listeners coleção para um rastreamento ou uma origem de rastreamento. 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
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.
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.
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 adicionar elementos a TextWriterTraceListener textListener para o sharedListeners coleção. textListeneré adicionado por nome 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>