<clear Element for listeners for trace (Elemento clear> para <serviços de> escuta para <rastreio)>

Artigo
05/10/2023

Limpa a Listeners coleção para rastreio.

<configuração>
  <system.diagnostics>
    <rastreio>
      <serviços de escuta>
        <limpar>

Syntax

<clear/>

Atributos e Elementos

As secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Nenhum.

Elementos Subordinados

Nenhum.

Elementos Principais

Elemento	Descrição
`configuration`	O elemento raiz em cada ficheiro de configuração utilizado pelo runtime de linguagem comum e .NET Framework aplicações.
`system.diagnostics`	Especifica os serviços de escuta de rastreio que recolhem, armazenam e encaminham mensagens e o nível em que é definido um comutador de rastreio.
`trace`	Contém serviços de escuta que recolhem, armazenam e encaminham mensagens de rastreio.
`listeners`	Contém serviços de escuta que recolhem, armazenam e encaminham mensagens. Os serviços de escuta direcionam a saída de rastreio para um destino adequado.

Observações

O <clear> elemento remove todos os serviços de escuta da Listeners coleção para rastreio. Pode utilizar o <clear> elemento antes de utilizar o <add> elemento para ter a certeza de que não existem outros serviços de escuta ativos na coleção.

Pode limpar a Listeners coleção através de programação ao chamar o Clear método na Trace.Listeners propriedade (System.Diagnostics.Trace.Listeners.Clear()).

Este elemento pode ser utilizado no ficheiro de configuração do computador (Machine.config) e no ficheiro de configuração da aplicação.

Nota

O <clear> elemento remove o DefaultTraceListener da Listeners coleção, alterando o comportamento dos Debug.Assertmétodos , Trace.Assert, Debug.Faile Trace.Fail . Chamar um Assert método ou Fail normalmente resulta na apresentação de uma caixa de mensagem. No entanto, a caixa de mensagem não é apresentada se não DefaultTraceListener estiver na Listeners coleção.

Exemplo

O exemplo seguinte mostra como utilizar o <clear> elemento antes de utilizar o <add> elemento para adicionar o serviço de escuta console à Listeners coleção para rastreio.

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

Partilhar via