<listeners> elemento para <trace>

Especifica un agente de escucha que recopila, almacena y enruta mensajes. Los agentes de escucha dirigen la salida de seguimiento a un destino adecuado.

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

Syntax

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

Atributos y elementos

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

Attributes

Ninguno.

Elementos secundarios

Elemento Description
<agregar> Agrega un agente de escucha a la Listeners colección.
<claro> Borra la Listeners colección de seguimiento.
<eliminar> Quita un agente de escucha de la Listeners colección.

Elementos primarios

Elemento Description
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 mensajes de seguimiento.

Observaciones

Las Debug clases y Trace comparten la misma Listeners colección. 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 TraceListener clase .

Archivo de configuración

Este elemento se puede usar en el archivo de configuración de la máquina (Machine.config) y en el archivo de configuración de la aplicación.

Example

En el ejemplo siguiente se muestra cómo usar el <listeners> elemento para agregar los agentes MyListener de escucha y MyEventListener a la Listeners colección. 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

  • Last updated on