Elemento <clear> para <listeners> para <trace>

  • Artigo

Limpa a coleção Listeners do rastreamento.

<configuração>
  <system.diagnostics>
    <rastreamento>
      <ouvintes>
        <clear>

Syntax

<clear/>

Atributos e elementos

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

Atributos

Nenhum.

Elementos filho

Nenhum.

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.
trace Contém os ouvintes que coletam, armazenam e roteiam mensagens de rastreamento.
listeners Contém ouvintes que coletam, armazenam e roteiam mensagens. Os ouvintes direcionam a saída de rastreamento para um destino apropriado.

Comentários

O elemento <clear> remove todos os ouvintes da coleção Listeners para rastreamento. É possível usar o elemento <clear> antes de usar o elemento <add> para ter certeza de que não há outros ouvintes ativos na coleção.

Você pode limpar a coleção Listeners programaticamente chamando o método Clear na propriedade Trace.Listeners (System.Diagnostics.Trace.Listeners.Clear()).

Esse elemento pode ser usado no arquivo de configuração de computador (Machine.config) e no arquivo de configuração de aplicativo.

Observação

O elemento <clear> remove DefaultTraceListener da coleção Listeners, e altera o comportamento dos métodos Debug.Assert, Trace.Assert, Debug.Fail e Trace.Fail. Chamar um método Assert ou Fail normalmente resulta na exibição de uma caixa de mensagem. No entanto, a caixa de mensagem não será exibida se DefaultTraceListener não estiver na coleção Listeners.

Exemplo

O exemplo a seguir mostra como usar o elemento <clear> antes de usar o elemento <add> para adicionar o ouvinte console à coleção Listeners para o rastreamento.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <clear/>  
        <add name="console"
          type="System.Diagnostics.ConsoleTraceListener" >  
          <filter type="System.Diagnostics.EventTypeFilter"
            initializeData="Error" />  
        </add>  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>

Confira também