<desmarcar>Elemento para <listeners>para <fonte>

Artigo
08/25/2010

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

<configuration> Element
  elemento <sistema.Diagnóstico>
    Elemento <sources>
      Elemento <fonte>
        Elemento <listeners>para <trace>
          <desmarcar>Elemento para <listeners>para <fonte>

<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 pelo Common linguagem tempo de execução e aplicativos do .NET estrutura.
system.diagnostics	Especifica os ouvintes de rastreamento que coletar, armazenar, e rota mensagens e o nível em que um comutador de rastreamento está definido.
sources	Contém fontes de rastreamento que iniciam a mensagens de rastreamento.
source	Especifica uma fonte de rastreamento que inicia a mensagens de rastreamento.
listeners	Especifica os ouvintes que coletam, armazenam e rotear mensagens.

Comentários

The <clear> elemento remove todos os ouvintes da Listeners coleção para uma fonte de rastreamento, incluindo o DefaultTraceListener. Você pode usar o <clear> elemento antes de usar o <add> elemento para ser determinadas lá não são outros ouvintes nenhum ativo na coleção.

Arquivo de configuração

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

Exemplo

O exemplo a seguir mostra como usar o <clear> elemento antes de usar o <add> elementos para adicionar os ouvintes console e textListener para o Listeners coleção da fonte 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>