Compartir a través de


Elemento <filter> de <add> de <listeners> de <trace>

Actualización: noviembre 2007

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

<configuration> (Elemento)
  Elemento <system.diagnostics>
    Elemento <trace>
      Elemento <listeners> para <trace>
        Elemento <add> de <listeners> de <trace>
          Elemento <filter> de <add> de <listeners> de <trace>

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

Atributos y elementos

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

Atributos

Atributo

Descripción

type

Atributo necesario.

Especifica el tipo del filtro, que debería heredar de la clase TraceFilter. Puede utilizar el nombre completo del tipo del espacio de nombres, que corresponde a la propiedad FullName del tipo, o bien, usar el nombre de tipo completo incluyendo la información del ensamblado, que corresponde a la propiedad AssemblyQualifiedName. Para obtener información detallada sobre los nombres de tipo completos, vea Especificar nombres de tipo completos.

initializeData

Atributo opcional.

Cadena pasada al constructor de la clase de filtro especificada.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento

Descripción

configuration

Es el elemento raíz de cada archivo de configuración que utilizan las aplicaciones Common Language Runtime y .NET Framework.

system.diagnostics

Especifica los agentes de escucha de seguimiento que recopilan, almacenan y enrutan mensajes, y el nivel donde se establece un modificador de seguimiento.

trace

Contiene agentes de escucha que recopilan, almacenan y enrutan mensajes de seguimiento.

listeners

Contiene agentes de escucha que recopilan, almacenan y enrutan mensajes. Los agentes de escucha dirigen el resultado del seguimiento a un destino apropiado.

add

Agrega un agente de escucha a la colección Listeners.

Comentarios

El elemento <filter> debe estar contenido en un elemento <add> de un agente de escucha de seguimiento que especifica el tipo del agente de escucha, no sólo el nombre de un agente de escucha definido en un <sharedListeners> (Elemento). Si el agente de escucha está definido en <sharedListeners> (Elemento), el filtro de ese agente de escucha debe estar definido en ese elemento.

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

Ejemplo

El ejemplo siguiente muestra cómo utilizar el elemento <filter> para agregar un filtro al agente de escucha console de la colección Listeners para un seguimiento, especificando el nivel de evento del filtro 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>

Vea también

Referencia

Esquema de la configuración de seguimiento y depuración

Trace

TraceListener

TraceListener.Filter

TraceFilter