<add>Elemento para <sharedlisteners>

Artigo
08/25/2010

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

<configuration> Element
  elemento <sistema.Diagnóstico>
    Elemento <sharedlisteners>
      <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
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 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.

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

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 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.
sharedListeners	Uma coleção de ouvintes de que qualquer fonte ou elemento trace fazem referência.

Comentários

As classes de ouvinte fornecidas com o .NET estrutura derivam do TraceListener classe. O valor para o name atributo é usado para adicionar o ouvinte compartilhado para um Listeners coleção para um rastreamento ou de uma fonte 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 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
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.
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.
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

The following example shows how to use <add> elements to add the TextWriterTraceListener textListener to the sharedListeners collection. textListener adicionados por nome 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>