Elemento <listeners> para <source>

  • Artigo

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

<configuração>
  <system.diagnostics>
    <sources>
      <source>
        <listeners>

Syntax

<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> Adiciona um ouvinte na coleção Listeners.
<remove> Remove um ouvinte da coleção Listeners.
<clear> Limpa a coleção Listeners de uma origem de rastreamento.

Elementos pai

Elemento Descrição
configuration O elemento raiz em cada arquivo de configuração usado pelos aplicativos do Common Language Runtime e .NET Framework.
system.diagnostics Especifica os ouvintes de rastreamento que coletam, armazenam e roteiam mensagens e o nível em que uma opção de rastreamento é definida.
sources Contém as origens de rastreamento que iniciam as 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 do computador (Machine.config) e no arquivo de configuração de aplicativo.

Exemplo

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

<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>

Confira também