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

Artículo
08/10/2011

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.

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>