Compartir a través de

<Elemento de filtro> para agregar< para ><clientes de escucha> para <origen>

  • Artículo

Agrega un filtro a un agente de escucha en la colección Listeners para un origen de seguimiento.

<configuración>
  <system.diagnostics>
    <sources>
      <origen>
        <agentes de escucha>
          <agregar>
            <filtro>

Sintaxis

<filter
  type="traceFilterClassName"
  initializeData="data" />

Atributos y elementos

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo Descripción
type Atributo necesario.

Especifica el tipo del filtro, que se debe heredar de la clase TraceFilter. Puede usar el nombre completo del espacio de nombres del tipo, que se corresponde con la propiedad FullName del tipo, o bien puede usar el nombre del tipo completo, incluida la información del ensamblado, que se corresponde con la propiedad AssemblyQualifiedName. Para más información sobre los nombres de tipo completos, consulte Especificar nombres de tipo completos.
initializeData Atributo opcional.

Cadena pasada al constructor para la clase de filtro especificada.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento Descripción
configuration Elemento raíz de cada archivo de configuración usado por las aplicaciones de Common Language Runtime y .NET Framework.
system.diagnostics Especifica los agentes de escucha de seguimiento que recopilan, almacenan y enrutan mensajes, así como el nivel en el que está establecido un modificador de seguimiento.
sources Contiene orígenes de seguimiento que inician mensajes de seguimiento.
source Contiene un origen de seguimiento que inicia mensajes de seguimiento.
listeners Contiene agentes de escucha que recopilan, almacenan y enrutan los mensajes de seguimiento. Los agentes de escucha dirigen los resultados del seguimiento a un destino apropiado.
add Agrega un agente de escucha a la colección Listeners para un origen de seguimiento.

Comentarios

El elemento <filter> debe estar incluido en un elemento <add> para un agente de escucha de origen de seguimiento que especifica el tipo del agente de escucha, no solo el nombre de un agente de escucha definido en <sharedListeners>. Si el agente de escucha se define en <sharedListeners>, el filtro para ese agente de escucha debe definirse en ese elemento.

Este elemento se puede usar en el archivo de configuración del equipo (Machine.config) o en el archivo de configuración de la aplicación.

Ejemplo

En el ejemplo siguiente se muestra cómo usar el <filter> elemento para agregar un filtro al agente de escucha consoleen la Listeners colección para el origen de seguimiento myTraceSource, especificando el nivel de evento de filtro 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>

Consulte también