DelimitedListTraceListener Clase

Definición

Dirige los resultados de traza o de depuración a un escritor de texto, como un escritor de secuencias, o a una secuencia, como una secuencia de archivo.

public ref class DelimitedListTraceListener : System::Diagnostics::TextWriterTraceListener
public class DelimitedListTraceListener : System.Diagnostics.TextWriterTraceListener
type DelimitedListTraceListener = class
    inherit TextWriterTraceListener
Public Class DelimitedListTraceListener
Inherits TextWriterTraceListener
Herencia
Herencia
DelimitedListTraceListener

Comentarios

El resultado del seguimiento está en un formato de texto delimitado que utiliza el delimitador especificado por la propiedad Delimiter. El delimitador se usa para finalizar cada campo en una línea de salida. Por ejemplo, para mostrar la salida de seguimiento en una hoja de cálculo de Excel de Microsoft, puede especificar una coma (",") como delimitador y crear un archivo de valor separado por comas (CSV).

Importante

Este tipo implementa la interfaz IDisposable. Cuando haya terminado de utilizar el tipo, debe desecharlo directa o indirectamente. Para eliminar el tipo directamente, llame a su Dispose método en untry/catch bloque . Para deshacerse de él indirectamente, use una construcción de lenguaje como using (en C#) o Using (en Visual Basic). Para más información, vea la sección "Uso de objetos que implementan IDisposable" en el tema de la interfaz IDisposable.

Puede crear un DelimitedListTraceListener en el código. Como alternativa, solo en las aplicaciones de .NET Framework, puede habilitar o deshabilitar un DelimitedListTraceListener mediante el archivo de configuración de la aplicación y, a continuación, usar el configurado DelimitedListTraceListener en la aplicación.

Nota

Delimita DelimitedListTraceListener solo el texto que se emite mediante los métodos que tienen nombres a partir de la palabra Trace, como DelimitedListTraceListener.TraceEvent o Trace.TraceWarning. Los datos de seguimiento emitidos mediante los Debug.Write métodos y TextWriterTraceListener.WriteLine no están delimitados.

Para configurar en DelimitedListTraceListener una aplicación de .NET Framework, edite el archivo de configuración correspondiente al nombre de la aplicación. En este archivo, puede agregar un agente de escucha, establecer las propiedades de un agente de escucha o quitar un agente de escucha. El archivo de configuración debe tener el formato tal y como se muestra en el ejemplo siguiente:

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="delimitedListener"   
          type="System.Diagnostics.DelimitedListTraceListener"   
          delimiter=","   
          initializeData="delimitedOutput.csv"   
          traceOutputOptions="ProcessId, DateTime" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

Nota

Si intenta escribir en un archivo que está en uso o no disponible, el nombre de archivo se prefijo automáticamente mediante un GUID.

Nota

Los agentes de escucha están diseñados para ser utilizados por métodos de las Debugclases , Tracey TraceSource para escribir información de seguimiento. Los métodos de agente de escucha, excepto los constructores, no deben llamarse directamente desde el código de la aplicación.

Constructores

DelimitedListTraceListener(Stream)

Inicializa una nueva instancia de la clase DelimitedListTraceListener que escribe en el flujo de salida especificado.

DelimitedListTraceListener(Stream, String)

Inicializa una nueva instancia de la clase DelimitedListTraceListener que escribe en el flujo de salida especificado y tiene el nombre especificado.

DelimitedListTraceListener(String)

Inicializa una nueva instancia de la clase DelimitedListTraceListener que escribe en el archivo especificado.

DelimitedListTraceListener(String, String)

Inicializa una nueva instancia de la clase DelimitedListTraceListener que escribe en el archivo especificado y tiene el nombre especificado.

DelimitedListTraceListener(TextWriter)

Inicializa una nueva instancia de la clase DelimitedListTraceListener que escribe en el escritor de texto especificado.

DelimitedListTraceListener(TextWriter, String)

Inicializa una nueva instancia de la clase DelimitedListTraceListener que escribe en el escritor de texto especificado y tiene el nombre especificado.

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.

(Heredado de TraceListener)
Delimiter

Obtiene o establece el delimitador de la lista delimitada.

Filter

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

(Heredado de TraceListener)
IndentLevel

Obtiene o establece el nivel de sangría.

(Heredado de TraceListener)
IndentSize

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

(Heredado de TraceListener)
IsThreadSafe

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

(Heredado de TraceListener)
Name

Obtiene o establece un nombre para este objeto TraceListener.

(Heredado de TraceListener)
NeedIndent

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

(Heredado de TraceListener)
TraceOutputOptions

Obtiene o establece las opciones de los resultados de seguimiento.

(Heredado de TraceListener)
Writer

Obtiene o establece el escritor de texto que recibe los resultados de la traza o la depuración.

(Heredado de TextWriterTraceListener)

Métodos

Close()

Cierra Writer para que ya no se reciba ningún resultado de la traza o la depuración.

(Heredado de TextWriterTraceListener)
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.

(Heredado de TraceListener)
Dispose(Boolean)

Desecha este objeto TextWriterTraceListener.

(Heredado de TextWriterTraceListener)
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.

(Heredado de 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.

(Heredado de TraceListener)
Flush()

Vacía el búfer de resultados de la propiedad Writer.

(Heredado de TextWriterTraceListener)
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()

Devuelve el atributo de archivo de configuración personalizado que admite el agente de escucha de seguimiento delimitado.

GetSupportedAttributes()

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

(Heredado de TraceListener)
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 el archivo de salida o el flujo de salida.

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 el archivo de salida o el flujo de salida.

TraceEvent(TraceEventCache, String, TraceEventType, Int32)

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

(Heredado de TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Escribe la información de seguimiento, un mensaje y la información de evento en el archivo de salida o el flujo de salida.

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 el archivo de salida o el flujo de salida.

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.

(Heredado de TraceListener)
Write(Object)

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

(Heredado de 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.

(Heredado de TraceListener)
Write(String)

Escribe un mensaje en la propiedad Writer de esta instancia.

(Heredado de TextWriterTraceListener)
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.

(Heredado de 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.

(Heredado de TraceListener)
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.

(Heredado de TraceListener)
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.

(Heredado de TraceListener)
WriteLine(String)

Escribe en la propiedad Writer de esta instancia un mensaje seguido de un terminador de línea. El terminador de línea predeterminado corresponde a un retorno de carro seguido de un avance de línea (\r\n).

(Heredado de TextWriterTraceListener)
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.

(Heredado de TraceListener)

Se aplica a