Elemento <listeners> para <trace>

  • Artículo

Especifica un agente de escucha que recopila, almacena y enruta mensajes. Los agentes de escucha dirigen los resultados del seguimiento a un destino apropiado.

<configuration>
  <system.diagnostics>
    <trace>
      <listeners>

Sintaxis

<listeners>
  <add>...</add>  
  <clear/>  
  <remove ... />  
</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.
<clear> Borra la colección Listeners de un seguimiento.
<remove> Quita un agente de escucha de la colección Listeners.

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.
trace Contiene agentes de escucha que recopilan, almacenan y enrutan los mensajes de seguimiento.

Comentarios

Las clases Debug y Trace comparten la misma colección de agentes de escucha. Si agrega un objeto de escucha a la colección en una de estas clases, la otra clase usa el mismo agente de escucha. Las clases de agente de escucha enviadas con .NET Framework derivan de la clase TraceListener.

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 los agentes MyListener y MyEventListener a la colección Listeners. MyListener crea un archivo denominado MyListener.log y escribe la salida en el archivo. MyEventListener crea una entrada en el registro de eventos.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="true" indentsize="0">  
      <listeners>  
        <add name="myListener"
          type="System.Diagnostics.TextWriterTraceListener,
            system, version=1.0.3300.0, Culture=neutral,
            PublicKeyToken=b77a5c561934e089"
          initializeData="c:\myListener.log" />  
        <add name="MyEventListener"  
          type="System.Diagnostics.EventLogTraceListener,
            system, version=1.0.3300.0, Culture=neutral,
            PublicKeyToken=b77a5c561934e089"  
          initializeData="MyConfigEventLog"/>  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>

Consulte también