Compartilhar via

<elemento filter> para <adicionar> para <ouvintes> de origem <>

  • Artigo

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

<configuration>
  <system.diagnostics>
    <sources>
      <source>
        <ouvintes>
          <add>
            <filter>

Syntax

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

Atributos e elementos

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

Atributos

Atributo Descrição
type Atributo obrigatório.

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

A cadeia de caracteres passada para o construtor da classe de filtro especificada.

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 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 na coleção Listeners de uma origem de rastreamento.

Comentários

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

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 <filter> elemento para adicionar um filtro ao ouvinte console na Listeners coleção da origem myTraceSourcedo rastreamento, especificando o nível de evento de 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>

Confira também