<add> Element para <ouvintes> para <origem>

Artigo
04/06/2024

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

<configuração>
  <system.diagnostics>
    <Fontes>
      <fonte>
        <ouvintes>
          <adicionar>

Sintaxe

<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	Description
`type`	Atributo obrigatório, a menos que você esteja fazendo referência a `sharedListeners` um ouvinte na coleção, caso em que você só precisa se referir a ele pelo nome (consulte o Exemplo). 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. A ConfigurationException é lançado se a classe não tiver um construtor que usa uma cadeia de caracteres.
`name`	Atributo opcional. Especifica o nome do ouvinte.
`traceOutputOptions`	Atributo opcional. Especifica o valor da TraceOutputOptions propriedade para o ouvinte de rastreamento.
[atributos personalizados]	Atributos opcionais. Especifica o valor para atributos específicos do GetSupportedAttributes ouvinte identificados pelo método para esse ouvinte. Delimiter é um exemplo de um atributo extra exclusivo para a DelimitedListTraceListener classe.

Elementos Subordinados

Elemento	Description
<filter>	Adiciona um filtro a um ouvinte na `Listeners` coleção para uma fonte de rastreamento.

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.
`sources`	Contém fontes de rastreamento que iniciam mensagens de rastreamento.
`source`	Especifica uma fonte de rastreamento que inicia mensagens de rastreamento.
`listeners`	Especifica ouvintes que coletam, armazenam e roteiam mensagens.

Observações

As classes de ouvinte fornecidas com o .NET Framework derivam da TraceListener classe.

Se você não especificar o name atributo do ouvinte de rastreamento, a Name propriedade do ouvinte de rastreamento assumirá como padrão uma cadeia de caracteres vazia (""). Se seu aplicativo tiver apenas um ouvinte, você poderá adicioná-lo sem especificar um nome e removê-lo especificando uma cadeia de caracteres vazia para o nome. No entanto, se seu aplicativo tiver mais de um ouvinte, você deverá especificar um nome exclusivo para cada ouvinte de rastreamento, o TraceSource.Listeners que permite identificar e gerenciar ouvintes de rastreamento individuais na coleção.

Nota

Adicionar mais de um ouvinte de rastreamento do mesmo tipo e com o mesmo nome resulta em apenas um ouvinte de rastreamento desse tipo e nome sendo adicionado à Listeners coleção. No entanto, você pode adicionar programaticamente vários ouvintes idênticos à Listeners coleção.

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
System.Diagnostics.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.
System.Diagnostics.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
System.Diagnostics.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 os ouvintes console e textListener à Listeners coleção para a fonte 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