Elemento <listeners> para <source>

  • Artículo

Agrega o quita clientes de escucha de la colección Listeners para un TraceSource. Un cliente de escucha dirige la salida del seguimiento a un destino apropiado, como un registro, una ventana o un archivo de texto.

<configuration>
  <system.diagnostics>
    <sources>
      <source>
        <listeners>

Sintaxis

<listeners>
  <add>...</add>  
  <remove ... />  
  <clear/>  
</listeners>

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 Listeners.
<remove> Quita un cliente de escucha de la colección Listeners.
<clear> Borra la colección Listeners de un origen de seguimiento.

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, así como el nivel en el que está establecido un modificador de seguimiento.
sources Contiene orígenes de seguimiento que inician mensajes de seguimiento.
source Contiene un origen de seguimiento que inicia mensajes de seguimiento.

Comentarios

Archivo de configuración

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 <listeners> para agregar un cliente de escucha de seguimiento de la consola al origen mySource y eliminar el cliente de escucha de seguimiento predeterminado.

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="mySource" switchName="sourceSwitch"
        switchType="System.Diagnostics.SourceSwitch">  
        <listeners>  
          <add name="console"
            type="System.Diagnostics.ConsoleTraceListener">  
            <filter type="System.Diagnostics.EventTypeFilter"
              initializeData="Error"/>  
          </add>  
          <remove name="Default"/>  
        </listeners>  
      </source>  
    </sources>  
    <switches>  
      <add name="sourceSwitch" value="Warning"/>  
    </switches>  
  </system.diagnostics>  
</configuration>

Consulte también