<sharedListeners> (Elemento)

Actualización: noviembre 2007

Contiene agentes de escucha a los que puede hacer referencia cualquier origen o elemento de seguimiento. Estos agentes de escucha no reciben de forma predeterminada ningún seguimiento y no es posible recuperar estos agentes de escucha en tiempo de ejecución. Los agentes de escucha identificados como agentes de escucha compartidos se pueden agregar por nombre a los orígenes o seguimientos.

<configuration> (Elemento)
  Elemento <system.diagnostics>
    <sharedListeners> (Elemento)

<sharedListeners> 
  <add>...</add>
</sharedListeners>

Atributos y elementos

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

Atributos

Ninguna.

Elementos secundarios

Elemento	Descripción
Elemento <add> de <listeners> de <trace>	Agrega un agente de escucha a la colección sharedListeners.

Elementos primarios

Elemento	Descripción
Configuration	Elemento raíz de cada archivo de configuración que utilizan las aplicaciones Common Language Runtime y .NET Framework.
system.diagnostics	Especifica el elemento raíz de la sección de configuración de ASP.NET.

Comentarios

Agregar un agente de escucha a la colección de agentes de escucha compartidos no la convierte en un agente de escucha activo. Todavía es necesario agregarla a un origen de seguimiento o a un seguimiento incluyéndola en la colección Listeners de ese elemento de seguimiento. Las clases de agente de escucha incluidas en .NET Framework se derivan de la clase TraceListener.

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 <sharedListeners> para agregar el agente de escucha console a la colección Listeners para ambas clases, TraceSource y Trace. El agente de escucha de seguimiento de la consola escribe información de seguimiento en la consola a través de llamadas a TraceSource o Trace.

<system.diagnostics>
  <sources>
    <source name="mySource" switchName="sourceSwitch value="Verbose" >
      <listeners>
        <add name="console" />
      </listeners>
    </source>
  </sources>  
  <sharedListeners>    <add name="console" type="System.Diagnostics.ConsoleTraceListener" >      <filter type="System.Diagnostics.EventTypeFilter"         initializeData="Warning" />    </add>  </sharedListeners>
  <trace>
    <listeners>
      <add name="console" />
    </listeners>
  </trace>
</system.diagnostics> 

Vea también

Conceptos

Agentes de escucha de seguimiento

Referencia

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

TraceListener