TraceListener Clase

Definición

Espacio de nombres:: System.Diagnostics

Ensamblados:: netstandard.dll, System.Diagnostics.TraceSource.dll

Ensamblado:: System.Diagnostics.TraceSource.dll

Ensamblado:: System.dll

Ensamblado:: netstandard.dll

Source:: TraceListener.cs

Source:: TraceListener.cs

Source:: TraceListener.cs

Source:: TraceListener.cs

Source:: TraceListener.cs

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Proporciona la abstract clase base para los agentes de escucha que supervisan la salida de seguimiento y 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: Object

MarshalByRefObject
TraceListener

Herencia: Object
TraceListener

Derivado: Microsoft.VisualBasic.Logging.FileLogTraceListener

System.Diagnostics.DefaultTraceListener

System.Diagnostics.Eventing.EventProviderTraceListener

System.Diagnostics.EventLogTraceListener

System.Diagnostics.TextWriterTraceListener

Más…

Implementaciones: IDisposable

Comentarios

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

Debe habilitar el seguimiento o la depuración para usar un agente de escucha de seguimiento. La siguiente sintaxis 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

Herede 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

Nombre	Description
TraceListener()	Inicializa una nueva instancia de la clase TraceListener.
TraceListener(String)	Inicializa una nueva instancia de la TraceListener clase utilizando el nombre especificado como agente de escucha.

Propiedades

Nombre	Description
Attributes	Obtiene los atributos de agente de escucha de seguimiento personalizados 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 en una sangría.
IsThreadSafe	Obtiene un valor que indica si el agente de escucha de seguimiento es seguro para subprocesos.
Name	Obtiene o establece un nombre para este TraceListenerobjeto .
NeedIndent	Obtiene o establece un valor que indica si se va a sangr la salida.
TraceOutputOptions	Obtiene o establece las opciones de salida de seguimiento.

Métodos

Nombre	Description
Close()	Cuando se invalida en una clase derivada, cierra el flujo de salida para que ya no reciba la salida de seguimiento o depuración.
CreateObjRef(Type)	Crea un objeto que contiene toda la información pertinente necesaria para generar un proxy usado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Dispose()	Libera todos los recursos usados por .TraceListener
Dispose(Boolean)	Libera los recursos no administrados utilizados por TraceListener y, opcionalmente, libera los recursos administrados.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
Fail(String, String)	Emite un mensaje de error y un mensaje de error detallado al agente de escucha que crea al implementar la TraceListener clase .
Fail(String)	Emite un mensaje de error al agente de escucha que crea al implementar la TraceListener clase .
Flush()	Cuando se invalida en una clase derivada, vacía el búfer de salida.
GetHashCode()	Actúa como 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 Objectactual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto actual MarshalByRefObject . (Heredado de MarshalByRefObject)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Escribe información de seguimiento, un objeto de datos e información de eventos en la salida específica del agente de escucha.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Escribe información de seguimiento, una matriz de objetos de datos e información de eventos en la salida específica del agente de escucha.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Escribe información de seguimiento, una matriz con formato de objetos e información de eventos en la salida específica del agente de escucha.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Escribe información de seguimiento, un mensaje e información de eventos en la salida específica del agente de escucha.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Escribe información de seguimiento y eventos en la salida específica del agente de escucha.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Escribe información de seguimiento, un mensaje, una identidad de actividad relacionada e información de eventos en la salida específica del agente de escucha.
Write(Object, String)	Escribe un nombre de categoría y el valor del método del ToString() objeto en el agente de escucha que crea al implementar la TraceListener clase .
Write(Object)	Escribe el valor del método del ToString() objeto en el agente de escucha que cree al implementar la TraceListener clase .
Write(String, String)	Escribe un nombre de categoría y un mensaje en el agente de escucha que crea al implementar la TraceListener clase .
Write(String)	Cuando se reemplaza en una clase derivada, escribe el mensaje especificado en el agente de escucha que crea en la clase derivada.
WriteIndent()	Escribe la sangría en el agente de escucha que crea al implementar esta clase y restablece la NeedIndent propiedad en `false`.
WriteLine(Object, String)	Escribe un nombre de categoría y el valor del método del ToString() objeto en el agente de escucha que se crea al implementar la TraceListener clase, seguido de un terminador de línea.
WriteLine(Object)	Escribe el valor del método del ToString() objeto en el agente de escucha que crea al implementar la TraceListener clase, 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 crea al implementar la TraceListener clase, seguido de un terminador de línea.
WriteLine(String)	Cuando se reemplaza en una clase derivada, escribe un mensaje en el agente de escucha que crea en la clase derivada, seguido de un terminador de línea.

Se aplica a