Elemento <filter> para <add> para <sharedListeners>

  • Artigo

Adiciona um filtro a um ouvinte na coleção sharedListeners.

<configuration>
  <system.diagnostics>
    <sharedListeners>
      <add>
        <filter>

Syntax

<filter type="System.Diagnostics.EventTypeFilter"
  initializeData="Warning" />

Atributos e elementos

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

Atributos

Atributo Descrição
tipo Atributo obrigatório.

Especifica o tipo do filtro. Você pode usar apenas o nome completo do tipo (no formato da propriedade Type.FullName) ou usar o nome de tipo totalmente qualificado, incluindo as informações do assembly (no formato da propriedade Type.AssemblyQualifiedName). Para obter informações sobre como criar um nome de tipo totalmente qualificado, confira Como especificar nomes de tipo totalmente qualificados.
initializeData Atributo opcional.

A cadeia de caracteres passada para o construtor da classe 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.
sharedListeners Uma coleção de ouvintes que podem ser referenciados por qualquer elemento de origem ou de rastreamento.
add Adiciona um ouvinte à coleção sharedListeners.

Comentários

Se um ouvinte for definido em um elemento <add> do elemento <sharedListeners>, o filtro desse ouvinte deverá ser definido em um elemento <filter> que é filho do elemento <add>.

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 <filter> para adicionar um filtro ao ouvinte de rastreamento console na coleção sharedListeners.

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="myTraceSource" >  
        <listeners>  
          <add name="console" />  
          <remove name="Default" />  
        </listeners>  
      </source>  
    </sources>  
    <sharedListeners>  
      <add name="console"
        type="System.Diagnostics.ConsoleTraceListener" >  
        <filter type="System.Diagnostics.EventTypeFilter"
          initializeData="Error" />  
      </add>  
    </sharedListeners>  
  </system.diagnostics>  
</configuration>

Confira também