Elemento <filter> para <add> para <listeners> para <trace>

  • Artículo

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

<configuration>
  <system.diagnostics>
    <seguimiento>
      <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.
trace Contiene agentes de escucha que recopilan, almacenan y enrutan los mensajes de seguimiento.
listeners Contiene clientes de escucha que recopilan, almacenan y enrutan los mensajes. Los clientes de escucha dirigen los resultados del seguimiento a un destino apropiado.
add Agrega un agente de escucha a la colección Listeners.

Comentarios

El elemento <filter> debe estar incluido en un elemento <add> para un cliente de escucha de seguimiento que especifica el tipo del cliente de escucha, no solo el nombre de un cliente de escucha definido en <sharedListeners>. Si el cliente de escucha se define en <sharedListeners>, el filtro para ese cliente 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 elemento <filter> para agregar un filtro al cliente de escucha console en la colección Listeners del seguimiento, especificando el nivel de evento de 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>

Consulte también