Elemento <filter> para <add> de <listeners> de <source>

Artículo
12/12/2008

Actualización: noviembre 2007

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

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

<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 completos de tipos, vea Especificar nombres de tipo completos.
initializeData	Atributo opcional. Cadena pasada al constructor de la clase de filtro especificada.

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 completos de tipos, 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.
sources	Contiene orígenes de seguimiento que inician mensajes de seguimiento.
source	Especifica un origen de seguimiento que inicia 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 de un origen de seguimiento.

Comentarios

El elemento <filter> debe estar contenido en un elemento <add> de un agente de origen 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 del origen de seguimiento myTraceSource, especificando el nivel de eventos del 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>