<filter>Elemento para <add>para <sharedlisteners>

Artigo
08/25/2010

Adiciona um filtro para um ouvinte no sharedListeners coleção.

<configuration> Element
  elemento <sistema.Diagnóstico>
    Elemento <sharedlisteners>
      <add>Elemento para <sharedlisteners>
        <filter>Elemento para <add>para <sharedlisteners>

<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
type	Atributo obrigatório. Especifica o tipo do filtro. Você pode usar somente o nome completo do tipo (no formato do Type.FullName propriedade), ou você pode usar o nome de tipo totalmente qualificado, incluindo as informações de assembly (no formato de Type.AssemblyQualifiedName propriedade). Para obter informações sobre como criar um nome de tipo totalmente qualificado, consulte Especificando tipo nomes totalmente qualificados.
initializeData	Atributo opcional. A cadeia de caracteres passada para o construtor da classe especificada.

type

Atributo obrigatório.

Especifica o tipo do filtro. Você pode usar somente o nome completo do tipo (no formato do Type.FullName propriedade), ou você pode usar o nome de tipo totalmente qualificado, incluindo as informações de assembly (no formato de Type.AssemblyQualifiedName propriedade). Para obter informações sobre como criar um nome de tipo totalmente qualificado, consulte Especificando tipo nomes 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 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.
sharedListeners	Uma coleção de ouvintes de que qualquer fonte ou elemento trace fazem referência.
add	Adiciona um ouvinte para o sharedListeners coleção.

Comentários

Se um ouvinte for definido em um <add> elemento das <sharedListeners> elemento, o filtro para esse ouvinte deve ser definido em um <filter> elemento que é um filho do <add> elemento.

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 <filter> elemento para adicionar um filtro para o ouvinte de rastreamento console no 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>