<add> Element para <ouvintes> para <rastreamento>

Artigo
04/06/2024

Adiciona um ouvinte à coleção Listeners .

<configuração>
  <system.diagnostics>
    <Rastreio>
      <ouvintes>
        <adicionar>

Sintaxe

<add name="name"
     type="trace listener class name, 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. 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.
Designação	Atributo opcional. Especifica o nome do ouvinte.

Elementos Subordinados

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

Elementos Principais

Elemento	Description
`configuration`	O elemento raiz em cada arquivo de configuração usado pelo Common Language Runtime e aplicativos .NET Framework.
`listeners`	Especifica um ouvinte que coleta, armazena e roteia mensagens. Os ouvintes direcionam a saída de rastreamento para um destino apropriado.
`system.diagnostics`	Especifica o elemento raiz para a seção de configuração ASP.NET.
`trace`	Contém ouvintes que coletam, armazenam e roteiam mensagens de rastreamento.

Observações

As Debug classes e Trace compartilham a mesma coleção Listeners . Se você adicionar um objeto listener à coleção em uma dessas classes, a outra classe usará o mesmo ouvinte. As classes de ouvinte derivam do TraceListener.

Se você não especificar o name atributo do ouvinte de rastreamento, o Name padrão do ouvinte de rastreamento será 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 nomes exclusivos para cada ouvinte de rastreamento, o que permite identificar e gerenciar ouvintes de rastreamento individuais dentro das Listeners coleções e Listeners .

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 atributo initializeData 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 atributos initializeData .

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 em Console.Error; "`false`" para escrever para Console.Out.
System.Diagnostics.DelimitedListTraceListener	O nome do arquivo no qual o DelimitedListTraceListener arquivo grava.
System.Diagnostics.EventLogTraceListener	O nome do 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

Exemplo

O exemplo a seguir mostra como usar <adicionar> elementos para adicionar os ouvintes MyListener e MyEventListener para a coleção Listeners . MyListener Cria um arquivo chamado MyListener.log e grava a saída no arquivo. MyEventListener Cria uma entrada no log de eventos.

<configuration>  
   <system.diagnostics>  
      <trace autoflush="true" indentsize="0">  
         <listeners>  
            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="c:\myListener.log" />  
            <add name="MyEventListener"  
                 type="System.Diagnostics.EventLogTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"                 initializeData="MyConfigEventLog"/>  
            <add name="configConsoleListener"  
                 type="System.Diagnostics.ConsoleTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>  
         </listeners>  
      </trace>  
   </system.diagnostics>  
</configuration>

Partilhar via