Compartir a través de


Elemento <filter> de <add> de <sharedListeners>

Agrega un filtro a un agente de escucha contenido en la colección sharedListeners.

<filter type="System.Diagnostics.EventTypeFilter" 
  initializeData="Warning" />

Atributos y elementos

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

Atributos

Atributo

Descripción

type

Atributo necesario.

Especifica el tipo del filtro. Puede utilizar sólo el nombre completo del tipo (con el formato de la propiedad Type.FullName), o bien utilizar el nombre de tipo completo que incluya la información del ensamblado (con el formato de la propiedad Type.AssemblyQualifiedName). Para obtener información sobre cómo crear un nombre de tipo completo, vea Especificar nombres de tipo completos.

initializeData

Atributo opcional.

Cadena pasada al constructor de la clase 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.

sharedListeners

Colección de agentes de escucha a los que puede hacer referencia cualquier origen o elemento de seguimiento.

add

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

Comentarios

Si hay un agente de escucha definido en un elemento <add> del elemento <sharedListeners>, el filtro de ese agente de escucha se debe definir en un elemento <filter> que sea secundario del elemento <add>.

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 sharedListeners.

<configuration>
  <system.diagnostics>
    <sources>
      <source name="myTraceSource" >
        <listeners>
          <add name="console" />
          <remove name="Default" />
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add name="console" 
        type="System.Diagnostics.ConsoleTraceListener" >
        <filter type="System.Diagnostics.EventTypeFilter" 
          initializeData="Error" />
      </add>
    </sharedListeners>
  </system.diagnostics>
</configuration>

Vea también

Referencia

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

TraceFilter

TraceListener

TraceSource