Esta documentación está archivada y no tiene mantenimiento.

<sharedListeners> (Elemento)

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.

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

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

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

Atributos

Ninguno.

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

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

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 el SDK de .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.

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> 
Mostrar: