Partilhar via

<filter> Element for <add> for <sharedListeners>

  • Artigo

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

<configuração>
  <system.diagnostics>
    <sharedOuvintes>
      <adicionar>
        <filter>

Sintaxe

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

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. Você pode usar apenas o nome completo do tipo (no formato da propriedade) ou pode usar o nome do Type.FullName tipo totalmente qualificado, incluindo as informações do assembly (no formato da Type.AssemblyQualifiedName propriedade). Para obter informações sobre como criar um nome de tipo totalmente qualificado, consulte Especificando nomes de tipo totalmente qualificados.
initializeData Atributo opcional.

A cadeia de caracteres passada para o construtor para a classe 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.
sharedListeners Uma coleção de ouvintes que qualquer fonte ou elemento de rastreamento pode referenciar.
add Adiciona um ouvinte à coleção sharedListeners .

Observações

Se um ouvinte é definido em um <add> elemento do <sharedListeners> elemento , o filtro para esse ouvinte deve ser definido em um <filter> elemento que é filho do <add> 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 de rastreamento na sharedListeners coleção.

<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>

Consulte também