<desmarcar>Elemento para <listeners>para <trace>

Artigo
08/25/2010

Limpa o Listeners coleção para rastreamento.

<configuration> Element
  elemento <sistema.Diagnóstico>
    Elemento <trace>
      Elemento <listeners>para <trace>
        <desmarcar>Elemento para <listeners>para <trace>

<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 pelo Common linguagem tempo de execução e aplicativos do .NET estrutura.
system.diagnostics	Especifica os ouvintes de rastreamento que coletar, armazenar, e rota mensagens e o nível em que um comutador de rastreamento está definido.
trace	Contém os ouvintes que coletam, armazenam e encaminhar mensagens de rastreamento.
listeners	Contém os ouvintes que coletam, armazenam e rotear mensagens. Ouvintes de direcionar a saída de rastreamento para um destino apropriado.

Comentários

The <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 ser determinadas lá não são outros ouvintes nenhum ativo na coleção.

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

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

Observação:
O <clear> Remove elemento o DefaultTraceListener do Listeners coleção, alterar o comportamento das Debug.Assert, Trace.Assert, Debug.Fail, e Trace.Fail métodos. Chamando um Assert ou Fail método normalmente resultados na exibição de uma caixa de mensagem. No entanto, a caixa de mensagem não será exibida se o DefaultTraceListener não é na 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>