<add> Element for <sharedListeners>

Artigo
04/06/2024

Adiciona um ouvinte à sharedListeners coleção. sharedListeners é uma coleção de ouvintes que qualquer <fonte> ou <rastreamento> pode referenciar. Por padrão, os ouvintes na sharedListeners coleção não são colocados em uma Listeners coleção. Eles devem ser adicionados pelo nome à <origem> ou <rastreamento>. Não é possível obter os ouvintes na sharedListeners coleção em código em tempo de execução.

<configuração>
  <system.diagnostics>
    <sharedOuvintes>
      <adicionar>

Sintaxe

<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	Description
`name`	Atributo obrigatório. Especifica o nome do ouvinte usado para adicionar o ouvinte compartilhado a uma `Listeners` coleção.
`type`	Atributo obrigatório. Especifica o tipo de ouvinte. Você deve usar uma cadeia de caracteres que atenda aos requisitos especificados em Especificando nomes de tipo totalmente qualificados.
`initializeData`	Atributo opcional. A cadeia de caracteres passada para o construtor para a classe especificada.
`traceOutputOptions`	Atributo opcional. A representação de cadeia de caracteres de um ou mais TraceOptions membros de enumeração que indica os dados a serem gravados na saída de rastreamento. Vários itens são separados por vírgulas. O valor padrão é "None".

Elementos Subordinados

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

Elementos Principais

Elemento	Description
`configuration`	O elemento raiz em cada arquivo de configuração usado pelo Common Language Runtime e aplicativos .NET Framework.
`system.diagnostics`	Especifica 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 qualquer fonte ou elemento de rastreamento pode referenciar.

Observações

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

Nota

Quando você usa o initializeData atributo, você pode obter o aviso do compilador "O atributo 'initializeData' não é declarado." Esse aviso ocorre porque as definições de configuração são validadas em relação à classe TraceListenerbase abstrata , que não reconhece o initializeData atributo. Normalmente, você pode ignorar esse aviso para implementações de ouvinte de rastreamento que têm um construtor que usa um parâmetro.

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

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

Arquivo de configuração

Este elemento pode ser usado no arquivo de configuração da máquina (Machine.config) e no arquivo de configuração do aplicativo.

Exemplo

O exemplo a seguir mostra como usar <add> elementos para adicionar o TextWriterTraceListenertextListener à sharedListeners coleção. textListener é adicionado pelo nome à Listeners coleção para a origem TraceSourceAppde rastreamento. O textListener ouvinte 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>

Partilhar via