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

Artigo
08/01/2011

Limpa o Listeners coleção para rastreamento.

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

Comentários

O <clear> elemento remove todos os ouvintes da Listeners coleção para rastreamento. Você pode usar o <clear> elemento antes de usar o <add> elemento para ter certeza de que não há outros ouvintes nenhum ativos na coleção.

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

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

Observação

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

Exemplo

O exemplo a seguir mostra como usar o <clear> elemento antes de usar o <add> elemento para adicionar o ouvinte console para o Listeners coleção para 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>