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

Artigo
08/01/2011

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

<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 usadas pelos common language runtime e .NET Framework aplicativos.
system.diagnostics	Especifica os ouvintes de rastreamento que coletam, armazenam e roteiam mensagens e o nível em que um switch de rastreamento está definido.
sources	Contém fontes de rastreamento que iniciam mensagens de rastreamento.
source	Especifica uma origem de rastreamento que inicia as mensagens de rastreamento.
listeners	Especifica os ouvintes que coletam, armazenam e roteiam mensagens.

Comentários

O <clear> elemento remove todos os ouvintes da Listeners a coleção para uma origem de rastreamento, incluindo o DefaultTraceListener. Você pode usar o <clear> elemento antes de usar o <add> elemento para ter certeza de que não há outros ouvintes nenhum ativos na coleção.

Arquivo de configuração

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

Exemplo

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

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