<filter>Elemento para <add>para <listeners>para <fonte>

Artigo
08/25/2010

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

<configuration> Element
  elemento <sistema.Diagnóstico>
    Elemento <sources>
      Elemento <fonte>
        Elemento <listeners>para <trace>
          <add>Elemento para <listeners>para <trace>
            <filter>Elemento para <add>para <listeners>para <fonte>

<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, o que deve herdar a TraceFilter classe. Você pode usar o nome do tipo, que corresponde ao qualificada por namespaceFullName propriedade, ou você pode usar o nome de tipo totalmente qualificado, incluindo as informações de assembly, que corresponde da AssemblyQualifiedName propriedade. Para obter informações sobre nomes de tipo totalmente qualificado, consulte Especificando tipo nomes totalmente qualificados.
initializeData	Atributo opcional. A cadeia de caracteres passada para o construtor da classe do filtro especificado.

type

Atributo obrigatório.

Especifica o tipo de filtro, o que deve herdar a TraceFilter classe. Você pode usar o nome do tipo, que corresponde ao qualificada por namespaceFullName propriedade, ou você pode usar o nome de tipo totalmente qualificado, incluindo as informações de assembly, que corresponde da AssemblyQualifiedName propriedade. Para obter informações sobre nomes de tipo totalmente qualificado, consulte Especificando tipo nomes totalmente qualificados.

initializeData

Atributo opcional.

A cadeia de caracteres 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 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.
sources	Contém fontes de rastreamento que iniciam a mensagens de rastreamento.
source	Especifica uma fonte de rastreamento que inicia a mensagens de rastreamento.
listeners	Contém os ouvintes que coletam, armazenam e rotear mensagens. Ouvintes de direcionar a saída de rastreamento para um destino apropriado.
add	Adiciona um ouvinte para o Listeners coleção para uma fonte de rastreamento.

Comentários

The <filter> elemento deve estar contido em um <add> elemento de um ouvinte de fonte de rastreamento que especifica o tipo do ouvinte, não apenas o nome de um ouvinte definido em um Elemento <sharedlisteners>. Se o ouvinte for definido um Elemento <sharedlisteners>, o filtro para esse ouvinte deve ser definido no 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 sistema autônomo usar o <filter> elemento para adicionar um filtro para o ouvinte console no Listeners coleção da fonte de rastreamento de myTraceSource, especificando o nível do filtro de eventos sistema autônomo 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>