Compartir vía


TraceListener Clase

Definición

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

public ref class TraceListener abstract : MarshalByRefObject, IDisposable
public ref class TraceListener abstract : IDisposable
public abstract class TraceListener : MarshalByRefObject, IDisposable
public abstract class TraceListener : IDisposable
type TraceListener = class
    inherit MarshalByRefObject
    interface IDisposable
type TraceListener = class
    interface IDisposable
Public MustInherit Class TraceListener
Inherits MarshalByRefObject
Implements IDisposable
Public MustInherit Class TraceListener
Implements IDisposable
Herencia
TraceListener
Herencia
TraceListener
Derivado
Implementaciones

Comentarios

Para obtener ejemplos de cómo implementar un TraceListener, vea las DefaultTraceListenerTextWriterTraceListener clases y EventLogTraceListener .

Debe habilitar el seguimiento o la depuración para usar un agente de escucha de seguimiento. La sintaxis siguiente es específica del compilador. Si usa compiladores distintos de C# o Visual Basic, consulte la documentación del compilador.

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

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

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

<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 el uso de archivos de configuración para el seguimiento, consulte <system.diagnostics>.

Notas a los implementadores

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

Constructores

TraceListener()

Inicializa una nueva instancia de la clase TraceListener.

TraceListener(String)

Inicializa una nueva instancia de la clase TraceListener mediante el nombre especificado como el agente de escucha.

Propiedades

Attributes

Obtiene los atributos de agente de escucha de seguimiento personalizados que están definidos en el archivo de configuración de la aplicación.

Filter

Obtiene o establece el filtro de seguimiento para el agente de escucha de seguimiento.

IndentLevel

Obtiene o establece el nivel de sangría.

IndentSize

Obtiene o establece el número de espacios de una sangría.

IsThreadSafe

Obtiene un valor que indica si el agente de escucha de seguimiento es seguro para la ejecución de subprocesos.

Name

Obtiene o establece un nombre para este objeto TraceListener.

NeedIndent

Obtiene o establece un valor que indica si se va a aplicar sangría a los resultados.

TraceOutputOptions

Obtiene o establece las opciones de los resultados de seguimiento.

Métodos

Close()

Cuando se reemplaza en una clase derivada, se cierra el flujo de salida para que ya no reciba resultados de la traza o de la depuración.

CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.

(Heredado de MarshalByRefObject)
Dispose()

Libera todos los recursos que usa TraceListener.

Dispose(Boolean)

Libera los recursos no administrados que usa TraceListener y, de forma opcional, libera los recursos administrados.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
Fail(String)

Emite un mensaje de error para el agente de escucha que se crea al implementar la clase TraceListener.

Fail(String, String)

Emite un mensaje de error y un mensaje de error detallado para el agente de escucha que se crea al implementar la clase TraceListener.

Flush()

Cuando se reemplaza en una clase derivada, vacía el búfer de resultados.

GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetLifetimeService()
Obsoletos.

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
GetSupportedAttributes()

Obtiene los atributos personalizados admitidos por el agente de escucha de seguimiento.

GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
InitializeLifetimeService()
Obsoletos.

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.

(Heredado de MarshalByRefObject)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Escribe la información de seguimiento, un objeto de datos y la información de evento en los resultados específicos del agente de escucha.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Escribe la información de seguimiento, una matriz de objetos de datos y la información de evento en los resultados específicos del agente de escucha.

TraceEvent(TraceEventCache, String, TraceEventType, Int32)

Escribe la información de seguimiento y de evento en los resultados específicos del agente de escucha.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Escribe la información de seguimiento, un mensaje y la información de evento en los resultados específicos del agente de escucha.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Escribe la información de seguimiento, una matriz de objetos con formato y la información de evento en los resultados específicos del agente de escucha.

TraceTransfer(TraceEventCache, String, Int32, String, Guid)

Escribe la información de seguimiento, un mensaje, una identidad de actividad relacionada y la información de evento en los resultados específicos del agente de escucha.

Write(Object)

Escribe el valor del método ToString() del objeto en el agente de escucha que se crea al implementar la clase TraceListener.

Write(Object, String)

Escribe un nombre de categoría y el valor del método ToString() del objeto en el agente de escucha que se crea al implementar la clase TraceListener.

Write(String)

Cuando se reemplaza en una clase derivada, escribe el mensaje especificado en el agente de escucha que se crea en la clase derivada.

Write(String, String)

Escribe un nombre de categoría y un mensaje en el agente de escucha que se crea al implementar la clase TraceListener.

WriteIndent()

Escribe la sangría en el agente de escucha que se crea al implementar esta clase y restablece la propiedad NeedIndent en false.

WriteLine(Object)

Escribe el valor del método ToString() del objeto en el agente de escucha que se crea al implementar la clase TraceListener, seguido de un terminador de línea.

WriteLine(Object, String)

Escribe un nombre de categoría y el valor del método ToString() del objeto en el agente de escucha que se crea al implementar la clase TraceListener, seguidos de un terminador de línea.

WriteLine(String)

Cuando se reemplaza en una clase derivada, escribe un mensaje en el agente de escucha que se crea en la clase derivada, seguido de un terminador de línea.

WriteLine(String, String)

Escribe un nombre de categoría y un mensaje en el agente de escucha que se crea al implementar la clase TraceListener, seguidos de un terminador de línea.

Se aplica a

Seguridad para subprocesos

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

Consulte también