Elemento <listeners> para <trace>
Actualización: noviembre 2007
Especifica un agente de escucha que recopila, almacena y enruta mensajes. Los agentes de escucha dirigen el resultado del seguimiento a un destino apropiado.
<configuration> (Elemento)
Elemento <system.diagnostics>
Elemento <trace>
Elemento <listeners> para <trace>
<listeners>
<add>...</add>
<clear/>
<remove ... />
</listeners>
Atributos y elementos
En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.
Atributos
Ninguna.
Elementos secundarios
Elemento |
Descripción |
|---|---|
Agrega un agente de escucha a la colección Listeners. |
|
Borra la colección Listeners para seguimiento. |
|
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 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. |
trace |
Contiene agentes de escucha que recopilan, almacenan y enrutan mensajes de seguimiento. |
Comentarios
Las clases Debug y Trace comparten la misma colección Listeners. Si se agrega un objeto de agente de escucha a la colección en una de estas clases, la otra clase utilizará el mismo agente de escucha. Las clases de agente de escucha incluidas en .NET Framework se derivan de la clase TraceListener.
Archivo de configuración
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.
Ejemplo
En el siguiente ejemplo se muestra cómo utilizar el elemento <listeners> para agregar los agentes de escucha MyListener y MyEventListener a la colección Listeners. MyListener crea un archivo denominado MyListener.log y escribe el resultado 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>