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

Artículo
12/12/2008

Actualización: noviembre 2007

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

<configuration> (Elemento)
  Elemento <system.diagnostics>
    <sharedListeners> (Elemento)
      Elemento <add> para <sharedListeners>
        Elemento <filter> de <add> de <sharedListeners>

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

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