<add> Element para <ouvintes> para <rastreamento>
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>