<clear Element for listeners for trace (Elemento clear> para <serviços de> escuta para <rastreio)>
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>
Ver também
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários