Elemento <remove> para <listeners> para <source>

  • Artigo

Remove um ouvinte da coleção Listeners de uma origem de rastreamento.

<configuration>
  <system.diagnostics>
    <sources>
      <source>
        <listeners>
          <remove>

Syntax

<remove name="listenerName" />

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo Descrição
name Atributo obrigatório.

O nome do ouvinte a ser removido da coleção Listeners.

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 <remove> remove um ouvinte especificado da coleção Listeners para uma origem de rastreamento.

Você pode remover um elemento da coleção Listeners para uma origem de rastreamento programaticamente chamando o método Removena propriedade Listeners da instância TraceSource.

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

Exemplo

O exemplo a seguir mostra como usar o elemento <remove> antes de usar o elemento <add> para adicionar o ouvinte console à coleção Listeners para a origem de rastreamento TraceSourceApp.

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="TraceSourceApp" switchName="sourceSwitch"
         switchType="System.Diagnostics.SourceSwitch" >  
         <listeners>  
           <remove name="Default"/>  
           <add name="console"
             type="System.Diagnostics.ConsoleTraceListener" />  
         </listeners>  
      </source>  
    </sources>  
  </system.diagnostics>  
</configuration>

Confira também