Share via

<filter> Element for <add for <listeners>> for <source>

  • Artigo

Adiciona um filtro a um ouvinte na Listeners coleção para uma fonte de rastreamento.

<configuração>
  <system.diagnostics>
    <Fontes>
      <fonte>
        <ouvintes>
          <adicionar>
            <filter>

Sintaxe

<filter
  type="traceFilterClassName"
  initializeData="data" />

Atributos e Elementos

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

Atributos

Atributo Description
type Atributo obrigatório.

Especifica o tipo do filtro, que deve herdar da TraceFilter classe. Você pode usar o nome qualificado para namespace do tipo, que corresponde à propriedade do FullName tipo, ou pode usar o nome do tipo totalmente qualificado, incluindo as informações do assembly, que corresponde à AssemblyQualifiedName propriedade. Para obter informações sobre nomes de tipo totalmente qualificados, consulte Especificando nomes de tipo totalmente qualificados.
initializeData Atributo opcional.

A cadeia de caracteres passou para o construtor para a classe de filtro especificada.

Elementos Subordinados

Nenhum.

Elementos Principais

Elemento Description
configuration O elemento raiz em cada arquivo de configuração usado pelo Common Language Runtime e aplicativos .NET Framework.
system.diagnostics Especifica ouvintes de rastreamento que coletam, armazenam e roteiam mensagens e o nível em que uma opção de rastreamento é definida.
sources Contém fontes de rastreamento que iniciam mensagens de rastreamento.
source Especifica uma fonte de rastreamento que inicia mensagens de rastreamento.
listeners Contém ouvintes que coletam, armazenam e roteiam mensagens. Os ouvintes direcionam a saída de rastreamento para um destino apropriado.
add Adiciona um ouvinte à Listeners coleção para uma fonte de rastreamento.

Observações

O <filter> elemento deve estar contido em um <add> elemento para um ouvinte de origem de rastreamento que especifica o tipo de ouvinte, não apenas o nome de um ouvinte definido em um <sharedListeners>. Se o ouvinte for definido em um <sharedListeners>, o filtro para esse ouvinte deverá ser definido nesse elemento.

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

Exemplo

O exemplo a seguir mostra como usar o <filter> elemento para adicionar um filtro ao ouvinte console na Listeners coleção para a fonte myTraceSourcede rastreamento, especificando o nível de evento do filtro como Error.

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="myTraceSource" 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