Elemento <listeners>para <fonte>

Artigo
08/25/2010

Adiciona ou remove os ouvintes no Listeners coleção para um TraceSource. Um ouvinte direciona a saída de rastreamento para um destino apropriado, sistema autônomo um log, a janela ou o arquivo de texto.

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

<listeners> 
  <add>...</add>
  <remove ... />
  <clear/>
</listeners>

Atributos e elementos

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

Atributos

Nenhum.

Elementos filho

Elemento	Descrição
<add>Elemento para <listeners>para <fonte>	Adiciona um ouvinte para o Listeners coleção.
<remove>Elemento para <listeners>para <fonte>	Remove um ouvinte do Listeners coleção.
<desmarcar>Elemento para <listeners>para <fonte>	Limpa o Listeners coleção para uma fonte de rastreamento.

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.

Comentários

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 <listeners> elemento para adicionar um ouvinte de rastreamento do console para o mySource fonte e para remover o ouvinte de rastreamento padrão.

<configuration>
  <system.diagnostics>
    <sources>
      <source name="mySource" switchName="sourceSwitch" 
        switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <add name="console" 
            type="System.Diagnostics.ConsoleTraceListener">
            <filter type="System.Diagnostics.EventTypeFilter" 
              initializeData="Error"/>
          </add>
          <remove name="Default"/>
        </listeners>
      </source>
    </sources>
    <switches>
      <add name="sourceSwitch" value="Warning"/>
    </switches>
  </system.diagnostics>
</configuration>

Consulte também

Conceitos

Ouvintes de Rastrear

Referência

Rastreamento e esquema configurações Debug

TraceListener

Partilhar via