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

Artigo
08/01/2011

Adiciona um filtro para um ouvinte no Listeners coleção para uma origem de 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.

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.
sources	Contém fontes de rastreamento que iniciam mensagens de rastreamento.
source	Especifica uma origem de rastreamento que inicia as 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 para uma origem de rastreamento.

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 origem 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 coleção origem de rastreamento de myTraceSource, especificando o nível de filtro de eventos como Error.

<configuration>
  <system.diagnostics>
    <sources>
      <source name="myTraceSource" switchName="SourceSwitch" 
        switchType="System.Diagnostics.SourceSwitch"  >
        <listeners>
          <add name="console" 
            type="System.Diagnostics.ConsoleTraceListener" >
            <filter type="System.Diagnostics.EventTypeFilter" 
              initializeData="Error" />
          </add>
          <remove name="Default" />
        </listeners>
      </source>
    </sources>
    <switches>
      <add name="SourceSwitch" value="Warning" />
    </switches>
  </system.diagnostics>
</configuration>