Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés

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

 

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

<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 debería heredar de la clase TraceFilter. Puede utilizar el nombre del tipo completo con el 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 Specifying Fully Qualified Type Names.

initializeData

Atributo opcional.

Cadena pasada al constructor de 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, y el nivel donde se establece un modificador de seguimiento.

sources

Contiene orígenes de traza que inician mensajes de traza.

source

Especifica un origen de traza que inicia mensajes de traza.

listeners

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

ADD

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

El elemento <filter> debe estar contenido en un elemento <add> de un agente de origen de escucha de traza 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 traza 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>
Mostrar: