Compartilhar via

Elemento <add> para <sharedListeners>

  • Artigo

Adiciona um ouvinte na coleção sharedListeners. sharedListeners é uma coleção de ouvintes que podem ser referenciados por qualquer elemento de <origem> ou de <rastreamento>. Por padrão, os ouvintes da coleção sharedListeners não são colocados em uma coleção Listeners. Eles devem ser adicionados pelo nome à origem<> ou ao <rastreamento>. Não é possível colocar os ouvintes na coleção sharedListeners no código em tempo de execução.

<configuration>
  <system.diagnostics>
    <sharedListeners>
      <add>

Syntax

<add name="name"
  type="TraceListenerClassName, Version, Culture, PublicKeyToken"  
  initializeData="data"
  traceOutputOptions = "None"
/>

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 usado para adicionar o ouvinte compartilhado a uma coleção Listeners.
type Atributo obrigatório.

Especifica o tipo do ouvinte. Use uma cadeia de caracteres que atenda aos requisitos especificados em Especificar nomes de tipo totalmente qualificados.
initializeData Atributo opcional.

A cadeia de caracteres passada para o construtor da classe especificada.
traceOutputOptions Atributo opcional.

A representação de cadeia de caracteres de um ou mais membros de enumeração TraceOptions que indica os dados a serem gravados na saída de rastreamento. Itens múltiplos são separados por vírgulas. O valor padrão é “None”.

Elementos filho

Elemento Descrição
<filter> Adiciona um filtro a um ouvinte na coleção sharedListeners.

Elementos pai

Elemento Descrição
configuration O elemento raiz em cada arquivo de configuração usado pelos aplicativos do Common Language Runtime e .NET Framework.
system.diagnostics Especifica os ouvintes de rastreamento que coletam, armazenam e roteiam mensagens e o nível em que uma opção de rastreamento é definida.
sharedListeners Uma coleção de ouvintes que podem ser referenciados por qualquer elemento de origem ou de rastreamento.

Comentários

As classes de ouvinte enviadas com o .NET Framework derivam da classe TraceListener. O valor do atributo name é usado para adicionar o ouvinte compartilhado a uma coleção Listeners para um rastreamento ou uma fonte de rastreamento. O valor do atributo initializeData dependerá do tipo de ouvinte que você criar. Nem todos os ouvintes de rastreamento exigem que você especifique initializeData.

Observação

Ao usar o atributo initializeData, você poderá receber o aviso do compilador "O atributo 'initializeData' não é declarado". Esse aviso ocorre porque as definições de configuração são validadas na classe base abstrata TraceListener, que não reconhecerá o atributoinitializeData. Normalmente, é possível ignorar esse aviso para implementações de ouvinte de rastreamento que possuem um construtor que recebe um parâmetro.

A tabela a seguir mostra os ouvintes de rastreamento incluídos no .NET Framework e descreve o valor dos respectivos atributos initializeData.

Classe de ouvinte de rastreamento valor do atributo initializeData
ConsoleTraceListener O valor useErrorStream do construtor ConsoleTraceListener. Defina o atributo initializeData como "true" para gravar a saída de rastreamento e depuração para o fluxo de erro padrão e defina-o como "false" para gravar no fluxo de saída padrão.
DelimitedListTraceListener O nome do arquivo no qual o DelimitedListTraceListener é gravado.
System.Diagnostics.EventLogTraceListener O nome da origem de um log de eventos existente.
System.Diagnostics.EventSchemaTraceListener O nome do arquivo no qual o EventSchemaTraceListener é gravado.
System.Diagnostics.TextWriterTraceListener O nome do arquivo no qual o TextWriterTraceListener é gravado.
XmlWriterTraceListener O nome do arquivo no qual o XmlWriterTraceListener é gravado.

Arquivo de configuração

Esse elemento pode ser usado no arquivo de configuração do computador (Machine.config) e no arquivo de configuração de aplicativo.

Exemplo

O exemplo a seguir mostra como usar elementos <add> para adicionar a TextWriterTraceListenertextListener à coleçãosharedListeners. textListener é adicionado pelo nome à coleção Listeners para a origem do rastreamento TraceSourceApp. O ouvinte textListener grava a saída de rastreamento no 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>

Confira também