<clear> Element for <listeners> for <source>

Artigo
05/10/2023

Limpa a coleção de uma origem Listeners de rastreio.

<configuração>
  <system.diagnostics>
    <origens>
      <origem>
        <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.
`sources`	Contém origens de rastreio que iniciam mensagens de rastreio.
`source`	Especifica uma origem de rastreio que inicia mensagens de rastreio.
`listeners`	Especifica serviços de escuta que recolhem, armazenam e encaminham mensagens.

Observações

O <clear> elemento remove todos os serviços de escuta da coleção para uma origem Listeners de rastreio, incluindo o DefaultTraceListener. 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.

Ficheiro de Configuração

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

Exemplo

O exemplo seguinte mostra como utilizar o <clear> elemento antes de utilizar os <add> elementos para adicionar os serviços de console escuta e textListener à Listeners coleção da origem TraceSourceAppde rastreio .

<configuration>  
  <system.diagnostics>  
    <sources>  
       <source name="TraceSourceApp" switchName="sourceSwitch"
         switchType="System.Diagnostics.SourceSwitch">  
        <listeners>  
          <clear/>  
          <add name="console"
            type="System.Diagnostics.ConsoleTraceListener"/>  
          <add name="textListener"/>  
        </listeners>  
      </source>  
    </sources>  
    <sharedListeners>  
      <add name="textListener"
        type="System.Diagnostics.TextWriterTraceListener"
        initializeData="myListener.log"/>  
    </sharedListeners>  
    <switches>  
      <add name="sourceSwitch" value="Warning"/>  
    </switches>  
  </system.diagnostics>  
</configuration>

Partilhar via