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

Artigo
08/01/2011

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

<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 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 a criação de um nome de tipo totalmente qualificado, consulte Especificando tipo nomes totalmente qualificados.
initializeData	Atributo opcional. A seqüência passada para o construtor da classe especificada.

tipo

Atributo obrigatório.

Especifica o tipo do filtro. Você pode usar apenas o nome completo do tipo (no formato da 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 a criação de um nome de tipo totalmente qualificado, consulte Especificando tipo nomes totalmente qualificados.

initializeData

Atributo opcional.

A seqüência 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 usadas pelos common language runtime e .NET Framework aplicativos.
system.diagnostics	Especifica os ouvintes de rastreamento que coletam, armazenam e roteiam mensagens e o nível em que um switch de rastreamento está definido.
sharedListeners	Uma coleção de ouvintes de qualquer origem ou um elemento de rastreamento pode fazer referência.
add	Adiciona um ouvinte para o sharedListeners coleção.

Comentários

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

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

Exemplo

O exemplo a seguir mostra como usar o <filter> elemento para adicionar um filtro para o ouvinte de rastreamento console 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>