Partilhar via


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

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.

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>

Consulte também

Referência

Rastreamento e esquema configurações Debug

TraceFilter

TraceListener

TraceSource