TraceListener TraceListener TraceListener TraceListener Class

Definición

Proporciona la clase base abstract a los agentes de escucha que supervisan los resultados de seguimiento y de depuración. Provides the abstract base class for the listeners who monitor trace and debug output.

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

Comentarios

Para obtener ejemplos de cómo implementar un TraceListener, consulte el DefaultTraceListener, TextWriterTraceListener y EventLogTraceListener clases.For examples of how to implement a TraceListener, see the DefaultTraceListener, TextWriterTraceListener and the EventLogTraceListener classes.

Debe habilitar la traza o la depuración para utilizar un agente de escucha de seguimiento.You must enable tracing or debugging to use a trace listener. La sintaxis siguiente es específica del compilador.The following syntax is compiler specific. Si usa los compiladores que no sean de C# o Visual Basic, consulte la documentación del compilador.If you use compilers other than C# or Visual Basic, refer to the documentation for your compiler.

  • Para habilitar la depuración en C#, agregue el /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.To enable debugging in C#, add the /d:DEBUG flag to the compiler command line when you compile your code, or you can add #define DEBUG to the top of your file. En Visual Basic, agregue el /d:DEBUG=True marca a la línea de comandos del compilador.In Visual Basic, add the /d:DEBUG=True flag to the compiler command line.

  • Para habilitar el seguimiento en C#, agregue el /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.To enable tracing in C#, add the /d:TRACE flag to the compiler command line when you compile your code, or add #define TRACE to the top of your file. En Visual Basic, agregue el /d:TRACE=True marca a la línea de comandos del compilador.In Visual Basic, add the /d:TRACE=True flag to the compiler command line.

Para agregar un agente de escucha de seguimiento, edite el archivo de configuración que se corresponde con el nombre de la aplicación.To add a trace listener, edit the configuration file that corresponds to the name of your application. En este archivo, puede agregar un agente de escucha, establezca su tipo y su parámetro, quitar un agente de escucha o borrar todos los agentes de escucha previamente establecidos por la aplicación.Within this file, you can add a listener, set its type and set its parameter, remove a listener, or clear all the listeners previously set by the application. El archivo de configuración se debe dar formato similar al ejemplo siguiente.The configuration file should be formatted similar to the following example.

<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 los archivos de configuración para el seguimiento, vea <system.diagnostics>.For more information on using configuration files for tracing, see <system.diagnostics>.

Notas a los desarrolladores de herederos

Heredar de esta clase para implementar un agente de escucha personalizado para el Debug y Trace clases. Inherit from this class to implement a custom listener for the Debug and Trace classes. Como mínimo, debe implementar la Write(String) y WriteLine(String) métodos. At a minimum, you must implement the Write(String) and WriteLine(String) methods. Además, se puede implementar el Fail(String), Close() y Flush() métodos. Additionally, you can implement the Fail(String), Close() and Flush() methods.

Constructores

TraceListener() TraceListener() TraceListener() TraceListener()

Inicializa una nueva instancia de la clase TraceListener. Initializes a new instance of the TraceListener class.

TraceListener(String) TraceListener(String) TraceListener(String) TraceListener(String)

Inicializa una nueva instancia de la clase TraceListener mediante el nombre especificado como el agente de escucha. Initializes a new instance of the TraceListener class using the specified name as the listener.

Propiedades

Attributes Attributes Attributes 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. Gets the custom trace listener attributes defined in the application configuration file.

Filter Filter Filter Filter

Obtiene y establece el filtro de seguimiento para el agente de escucha de seguimiento. Gets and sets the trace filter for the trace listener.

IndentLevel IndentLevel IndentLevel IndentLevel

Obtiene o establece el nivel de sangría. Gets or sets the indent level.

IndentSize IndentSize IndentSize IndentSize

Obtiene o establece el número de espacios de una sangría. Gets or sets the number of spaces in an indent.

IsThreadSafe IsThreadSafe IsThreadSafe IsThreadSafe

Obtiene un valor que indica si el agente de escucha de seguimiento es seguro para la ejecución de subprocesos. Gets a value indicating whether the trace listener is thread safe.

Name Name Name Name

Obtiene o establece un nombre para este objeto TraceListener. Gets or sets a name for this TraceListener.

NeedIndent NeedIndent NeedIndent NeedIndent

Obtiene o establece un valor que indica si se va a aplicar sangría a los resultados. Gets or sets a value indicating whether to indent the output.

TraceOutputOptions TraceOutputOptions TraceOutputOptions TraceOutputOptions

Obtiene o establece las opciones de los resultados de seguimiento. Gets or sets the trace output options.

Métodos

Close() Close() Close() 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. When overridden in a derived class, closes the output stream so it no longer receives tracing or debugging output.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Libera todos los recursos que usa TraceListener. Releases all resources used by the TraceListener.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera los recursos no administrados que usa TraceListener y, de forma opcional, libera los recursos administrados. Releases the unmanaged resources used by the TraceListener and optionally releases the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual. Determines whether the specified object is equal to the current object.

(Inherited from Object)
Fail(String) Fail(String) Fail(String) Fail(String)

Emite un mensaje de error para el agente de escucha que se crea al implementar la clase TraceListener. Emits an error message to the listener you create when you implement the TraceListener class.

Fail(String, String) Fail(String, String) Fail(String, String) 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. Emits an error message and a detailed error message to the listener you create when you implement the TraceListener class.

Flush() Flush() Flush() Flush()

Cuando se reemplaza en una clase derivada, vacía el búfer de resultados. When overridden in a derived class, flushes the output buffer.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada. Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetSupportedAttributes() GetSupportedAttributes() GetSupportedAttributes() GetSupportedAttributes()

Obtiene los atributos personalizados admitidos por el agente de escucha de seguimiento. Gets the custom attributes supported by the trace listener.

GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual. Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del Object actual. Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual. Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual. Returns a string that represents the current object.

(Inherited from Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object) TraceData(TraceEventCache, String, TraceEventType, Int32, Object) TraceData(TraceEventCache, String, TraceEventType, Int32, 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. Writes trace information, a data object and event information to the listener specific output.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) 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. Writes trace information, an array of data objects and event information to the listener specific output.

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

Escribe la información de seguimiento y de evento en los resultados específicos del agente de escucha. Writes trace and event information to the listener specific output.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) 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. Writes trace information, a message, and event information to the listener specific output.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) 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. Writes trace information, a formatted array of objects and event information to the listener specific output.

TraceTransfer(TraceEventCache, String, Int32, String, Guid) TraceTransfer(TraceEventCache, String, Int32, String, Guid) TraceTransfer(TraceEventCache, String, Int32, String, Guid) 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. Writes trace information, a message, a related activity identity and event information to the listener specific output.

Write(Object) Write(Object) Write(Object) Write(Object)

Escribe el valor del método ToString() del objeto en el agente de escucha que se crea al implementar la clase TraceListener. Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

Write(Object, String) Write(Object, String) Write(Object, String) 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. Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

Write(String) Write(String) Write(String) 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. When overridden in a derived class, writes the specified message to the listener you create in the derived class.

Write(String, String) Write(String, String) Write(String, String) 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. Writes a category name and a message to the listener you create when you implement the TraceListener class.

WriteIndent() WriteIndent() WriteIndent() WriteIndent()

Escribe la sangría en el agente de escucha que se crea al implementar esta clase y restablece la propiedad NeedIndent en false. Writes the indent to the listener you create when you implement this class, and resets the NeedIndent property to false.

WriteLine(Object) WriteLine(Object) WriteLine(Object) 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. Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator.

WriteLine(Object, String) WriteLine(Object, String) WriteLine(Object, String) 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. Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator.

WriteLine(String) WriteLine(String) WriteLine(String) 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. When overridden in a derived class, writes a message to the listener you create in the derived class, followed by a line terminator.

WriteLine(String, String) WriteLine(String, String) WriteLine(String, String) 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. Writes a category name and a message to the listener you create when you implement the TraceListener class, followed by a line terminator.

Se aplica a

Seguridad para subprocesos

Este tipo es seguro para la ejecución de subprocesos. This type is thread safe.

Consultar también