<add>Elemento para <listeners>para <trace>
Adiciona um ouvinte para o Ouvintes coleção.
<configuration> Element
elemento <sistema.Diagnóstico>
Elemento <trace>
Elemento <listeners>para <trace>
<add>Elemento para <listeners>para <trace>
<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 |
Descrição |
---|---|
type |
Atributo obrigatório. Especifica o tipo do ouvinte. Você deve usar uma seqüência que atenda aos requisitos especificados em Especificando nomes de tipos totalmente qualificados. |
initializeData |
Atributo opcional. A cadeia de caracteres passada para o construtor da classe especificada. |
name |
Atributo opcional. Especifica o nome do ouvinte. |
Elementos filho
Nenhum.
Elementos pai
Elemento |
Descrição |
---|---|
configuration |
O elemento raiz em cada arquivo de configuração usado pelo Common linguagem tempo de execução e aplicativos do .NET estrutura. |
listeners |
Especifica um ouvinte que coleta, lojas e encaminha mensagens. Ouvintes de direcionar a saída de rastreamento para um destino apropriado. |
system.diagnostics |
Especifica o elemento raiz referente à seção de configuração do ASP.NET. |
trace |
Contém os ouvintes que coletam, armazenam e encaminhar mensagens de rastreamento. |
Comentários
The Debug e Trace classes compartilham o mesmo Ouvintes coleção. Se você adicionar um objeto de ouvinte à coleção em uma dessas classes, a Outros classe usa o mesmo ouvinte. As classes de ouvinte derivam do Classe TraceListener.
Se você não especificar o namatributo e do ouvinte de rastreamento, o Nameos padrões de ouvinte de rastreamento como uma seqüência de caracteres vazia (""). Se seu aplicativo tiver somente um ouvinte, você pode adicioná-la sem especificar um nome e removê-la, especificando uma seqüência de caracteres vazia para o nome. No entanto, se seu aplicativo tiver mais de um ouvinte, você deve especificar nomes exclusivos para cada ouvinte de rastreamento, que permite identificar e gerenciar os ouvintes de rastreamento individuais dentro de Listeners e Listeners coleções.
Observação: |
---|
Adição de mais de escuta de um rastreamento do mesmo tipo e com os mesmos resultados no ouvinte de rastreamento somente um nome do tipo e nome que está sendo adicionado à Listeners coleção. No entanto, você pode programaticamente adicionar vários ouvintes idênticos à Listeners coleção. |
O valor para o initializeData atributo depende do tipo de ouvinte que você criar. Nem todos os ouvintes de rastreamento requerem que você especifique initializeData.
Observação: |
---|
Quando você usa o initializeDataatributo, você pode obter o compilador de aviso "O atributo 'initializeData' não está declarado." Este aviso ocorre porque as definições de configuração são validadas em relação a classe base abstrata TraceListener, que não reconhece o initializeData atributo. Normalmente, você pode ignorar esse aviso para implementações de ouvinte de rastreamento que tem um construtor que aceita um parâmetro. |
A tabela a seguir mostra os ouvintes de rastreamento que estão incluídos no .NET estrutura e descreve o valor de seus initializeData atributos.
Classe do ouvinte de rastreamento |
valor do atributo initializeData |
---|---|
The useErrorStream valor para o ConsoleTraceListener construtor. conjunto o initializeDataatributo como"true"para gravar o rastreamento e depurar saída para Console.Error; "false"para gravar Console.Out. |
|
O nome do arquivo o DelimitedListTraceListener grava. |
|
O nome do nome de uma fonte de registro de eventos existente. |
|
O nome do arquivo que o EventSchemaTraceListener grava. |
|
O nome do arquivo que o TextWriterTraceListener grava. |
|
O nome do arquivo que o XmlWriterTraceListener grava. |
Exemplo
O exemplo a seguir mostra como usar <add> elementos para adicionar o ouvintes MyListener e MyEventListener para o Ouvintes coleção. MyListener cria um arquivo chamado MyListener.log e grava a saída para o 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>