Elemento <clear> para <listeners> para <source>

  • Artigo

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

<configuration>
  <system.diagnostics>
    <sources>
      <source>
        <ouvintes>
          <clear>

Syntax

<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 pelos aplicativos do Common Language Runtime e .NET Framework.
system.diagnostics Especifica os ouvintes de rastreamento que coletam, armazenam e roteiam mensagens e o nível em que uma opção de rastreamento é definida.
sources Contém as origens de rastreamento que iniciam as mensagens de rastreamento.
source Especifica uma origem de rastreamento que inicia as mensagens de rastreamento.
listeners Especifica ouvintes que coletam, armazenam e roteiam mensagens.

Comentários

O elemento <clear> remove todos os ouvintes da coleção Listeners para uma fonte de rastreamento, incluindo DefaultTraceListener. É possível usar o elemento <clear> antes de usar o elemento <add> para ter certeza de que não há outros ouvintes ativos na coleção.

Arquivo de configuração

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

Exemplo

O exemplo a seguir mostra como usar o elemento <clear> antes de usar o elemento <add> para adicionar os ouvintes console e textListener à coleção Listeners para a origem do rastreamentoTraceSourceApp.

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

Confira também