Partilhar via


<filter> Elemento para <add> Para <listeners> Para <trace>

Adiciona um filtro para um ouvinte no Listeners coleção para rastreamento.

<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 de filtro, deve herdar de TraceFilter classe. Você pode usar o nome qualificado por namespace do tipo, que corresponde ao tipo de FullName propriedade ou você pode usar o nome de tipo totalmente qualificado, incluindo as informações de assembly, que corresponde do AssemblyQualifiedName propriedade. Para obter informações sobre nomes de tipo totalmente qualificado, consulte Especificando tipo nomes totalmente qualificados.

initializeData

Atributo opcional.

A seqüência passada para o construtor da classe do filtro especificado.

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.

trace

Contém os ouvintes que coletam, armazenam e roteiam mensagens de rastreamento.

listeners

Contém os ouvintes que coletam, armazenam e roteiam mensagens. Ouvintes de direcionam a saída de rastreamento para um destino apropriado.

add

Adiciona um ouvinte para o Listeners coleção.

Comentários

O <filter> elemento deve estar contido em um <add> não apenas o nome de um ouvinte de elemento para um ouvinte de rastreamento que especifica o tipo do ouvinte, definido em um <sharedListeners> Elemento. Se o ouvinte é definido em um <sharedListeners> Elemento, o filtro para esse ouvinte deve ser definido no 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 console na Listeners a coleção de trace, especificando o nível de filtro de eventos como Error.

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="4">
      <listeners>
        <add name="console" 
          type="System.Diagnostics.ConsoleTraceListener" >
          <filter type="System.Diagnostics.EventTypeFilter" 
            initializeData="Error" />
        </add>
        <remove name="Default" />
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>

Consulte também

Referência

Rastreamento e esquema configurações Debug

Trace

TraceListener

TraceListener.Filter

TraceFilter