<listeners> Elemento para <source>

Artigo
08/01/2011

Adiciona ou remove os ouvintes na Listeners coleção para um TraceSource. Um ouvinte direciona a saída de rastreamento para um destino adequado, como, por exemplo, um log, uma janela ou um arquivo de texto.

<listeners> 
  <add>...</add>
  <remove ... />
  <clear/>
</listeners>

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho, e elementos pai.

Atributos

Nenhum.

Elementos filho

Elemento	Descrição
<add> Elemento para <listeners> Para <source>	Adiciona um ouvinte para o Listeners coleção.
<remove> Elemento para <listeners> Para <source>	Remove um ouvinte da Listeners coleção.
<clear> Elemento para <listeners> Para <source>	Limpa o Listeners coleção para uma origem de rastreamento.

Elementos pai

Elemento	Descrição
configuration	O elemento raiz em cada arquivo de configuração usadas pelos common language runtime e .NET Framework aplicativos.
system.diagnostics	Especifica os ouvintes de rastreamento que coletam, armazenam e roteiam mensagens e o nível em que um switch de rastreamento está definido.
sources	Contém fontes de rastreamento que iniciam mensagens de rastreamento.
source	Especifica uma origem de rastreamento que inicia as mensagens de rastreamento.

Comentários

Arquivo de configuração

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

Exemplo

O exemplo a seguir mostra como usar o <listeners> elemento para adicionar um ouvinte de rastreamento do console para o mySource de origem e para remover o padrão de rastreamento ouvinte.

<configuration>
  <system.diagnostics>
    <sources>
      <source name="mySource" switchName="sourceSwitch" 
        switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <add name="console" 
            type="System.Diagnostics.ConsoleTraceListener">
            <filter type="System.Diagnostics.EventTypeFilter" 
              initializeData="Error"/>
          </add>
          <remove name="Default"/>
        </listeners>
      </source>
    </sources>
    <switches>
      <add name="sourceSwitch" value="Warning"/>
    </switches>
  </system.diagnostics>
</configuration>

Consulte também

Referência

Rastreamento e esquema configurações Debug

TraceListener

Conceitos

Ouvintes de rastreamento.

Compartilhar via