Exportar (0) Imprimir
Expandir todo

TraceListener (Clase)

Actualización: noviembre 2007

Proporciona la clase base abstract a los agentes de escucha que supervisan los resultados de seguimiento y de depuración.

Espacio de nombres:  System.Diagnostics
Ensamblado:  System (en System.dll)

[HostProtectionAttribute(SecurityAction::LinkDemand, Synchronization = true)]
public ref class TraceListener abstract : public MarshalByRefObject, 
	IDisposable
/** @attribute HostProtectionAttribute(SecurityAction.LinkDemand, Synchronization = true) */
public abstract class TraceListener extends MarshalByRefObject implements IDisposable
public abstract class TraceListener extends MarshalByRefObject implements IDisposable

hy72797k.alert_note(es-es,VS.90).gifNota:

El atributo HostProtectionAttribute aplicado a este tipo o miembro tiene el siguiente valor de la propiedad Resources: Synchronization. El atributo HostProtectionAttribute no afecta a las aplicaciones de escritorio (que normalmente se inician haciendo doble clic en un icono, escribiendo un comando o introduciendo una dirección URL en el explorador). Para obtener más información, vea la clase HostProtectionAttribute o Programación de SQL Server y atributos de protección del host.

Para obtener ejemplos sobre cómo implementar TraceListener, vea las clases DefaultTraceListener, TextWriterTraceListener y EventLogTraceListener.

Es preciso habilitar el seguimiento o la depuración para poder utilizar un agente de escucha de seguimiento. La sintaxis siguiente es específica del compilador. Si se utilizan compiladores que no sean C# o Visual Basic, consulte la documentación del compilador.

  • Para habilitar la depuración en C#, agregue el marcador /d:DEBUG a la línea de comandos del compilador, al compilar el código, o agregue #define DEBUG al principio del archivo. En Visual Basic, agregue el marcador /d:DEBUG=True a la línea de comandos del compilador.

  • Para habilitar el seguimiento en C#, agregue el marcador /d:TRACE a la línea de comandos del compilador en el momento de compilar el código o agregue #define TRACE al principio del archivo. En Visual Basic, agregue el marcador /d:TRACE=True a la línea de comandos del compilador.

Para agregar un agente de escucha de seguimiento, modifique el archivo de configuración que corresponde al nombre de la aplicación. En el archivo se puede agregar un agente de escucha y establecer su tipo y su parámetro, quitar un agente de escucha o borrar todos los agentes de escucha previamente establecidos por la aplicación. El archivo de configuración debe tener un formato similar al del siguiente ejemplo:

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="4">
      <listeners>
        <add name="myListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="TextWriterOutput.log" />
        <remove name="Default" />
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>

Para obtener más información sobre cómo utilizar los archivos de configuración para realizar el seguimiento, vea Elemento <system.diagnostics>.

Notas para los herederos:

Herede de esta clase con el fin de implementar un agente de escucha personalizado para las clases Debug y Trace. Como mínimo, debe implementar los métodos Write y WriteLine. Además, puede implementar los métodos Fail, Close y Flush.

Este tipo es seguro para la ejecución de subprocesos.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC, Xbox 360

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 3.5, 2.0, 1.0

XNA Framework

Compatible con: 2.0, 1.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft