Elemento <sharedListeners>

  • Artículo

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

<configuration>
  <system.diagnostics>
    <sharedListeners>

Sintaxis

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

Atributos y elementos

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

Atributos

Ninguno.

Elementos secundarios

Elemento Descripción
<add> 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 usado por las aplicaciones de 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 cliente de escucha a la colección de clientes de escucha compartidos no lo convierte en un cliente activo. Aún debe agregarse a un origen de seguimiento o a un seguimiento agregándolo a la colección Listeners de ese elemento de seguimiento. Las clases del cliente de escucha de .NET Framework se derivan de la clase TraceListener.

Este elemento se puede usar en el archivo de configuración del equipo (Machine.config) o en el archivo de configuración de la aplicación.

Ejemplo

En el ejemplo siguiente se muestra cómo usar el elemento <sharedListeners> para agregar el cliente de escucha console a la colección Listeners de las clases TraceSource y Trace. El cliente de escucha de seguimiento de la consola escribe información de seguimiento en la consola mediante llamadas a TraceSource o Trace.

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

Consulte también