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.Directs tracing or debugging output to a text writer, such as a stream writer, or to a stream, such as a file stream.

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

Comentarios

La salida del seguimiento se encuentra en un formato de texto delimitado que usa el delimitador especificado por la propiedad Delimiter.The trace output is in a delimited text format that uses the delimiter specified by the Delimiter property. El delimitador se usa para terminar cada campo en una línea de salida.The delimiter is used to terminate each field in a line of output. Por ejemplo, para mostrar el resultado del seguimiento en una hoja de cálculo de Microsoft Excel, puede especificar una coma (",") como delimitador y crear un archivo de valores separados por comas (CSV).For example, to display the trace output in a Microsoft Excel spreadsheet, you might specify a comma (",") as a delimiter and create a comma-separated value (CSV) file.

Importante

la interfaz IDisposable.IDisposable interface. Cuando haya terminado de utilizar el tipo, debe desecharlo directa o indirectamente.When you have finished using the type, you should dispose of it either directly or indirectly. Para eliminar el tipo directamente, llame a su método Dispose en untry/catch bloque.To dispose of the type directly, call its Dispose method in atry/catch block. Para deshacerse de él indirectamente, use una construcción de lenguaje como using (en C#) o Using (en Visual Basic).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Para más información, vea la sección "Uso de objetos que implementan IDisposable" en el tema de la interfaz IDisposable.For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Puede habilitar o deshabilitar un DelimitedListTraceListener a través del archivo de configuración de la aplicación y, a continuación, usar el DelimitedListTraceListener configurado en la aplicación.You can enable or disable a DelimitedListTraceListener through the application configuration file and then use the configured DelimitedListTraceListener in your application. Como alternativa, puede crear un DelimitedListTraceListener en el código.Alternately, you can create a DelimitedListTraceListener in your code.

Nota

El DelimitedListTraceListener delimita solo el texto que se emite utilizando los métodos que tienen nombres que comienzan por la palabra Trace, como DelimitedListTraceListener.TraceEvent o Trace.TraceWarning.The DelimitedListTraceListener delimits only text that is emitted by using the methods that have names starting with the word Trace, such as DelimitedListTraceListener.TraceEvent or Trace.TraceWarning. Los datos de seguimiento que se emiten mediante los métodos Debug.Write y TextWriterTraceListener.WriteLine no están delimitados.Trace data that is emitted by using the Debug.Write and TextWriterTraceListener.WriteLine methods is not delimited.

Para configurar un DelimitedListTraceListener, edite el archivo de configuración que se corresponde con el nombre de la aplicación.To configure a DelimitedListTraceListener, edit the configuration file that corresponds to the name of your application. En este archivo, puede Agregar un agente de escucha, establecer las propiedades de un agente de escucha o quitar un agente de escucha.In this file, you can add a listener, set the properties for a listener, or remove a listener. El archivo de configuración debe tener el formato que se muestra en el ejemplo siguiente:The configuration file should be formatted as shown in the following example:

<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 está disponible, el nombre de archivo se antepone automáticamente a un GUID.If you try to write to a file that is in use or unavailable, the file name is automatically prefixed by a GUID.

Nota

Los métodos de las clases Debug, Tracey TraceSource deben usar los agentes de escucha para escribir información de seguimiento.Listeners are intended to be used by methods of the Debug, Trace, and TraceSource classes to write trace information. No se debe llamar directamente a los métodos de agente de escucha, salvo para los constructores, desde el código de la aplicación.Listener methods, except for constructors, should not be called directly from application code.

Constructores

DelimitedListTraceListener(Stream)

Inicializa una nueva instancia de la clase DelimitedListTraceListener que escribe en el flujo de salida especificado.Initializes a new instance of the DelimitedListTraceListener class that writes to the specified output stream.

DelimitedListTraceListener(Stream, String)

Inicializa una nueva instancia de la clase DelimitedListTraceListener que escribe en el flujo de salida especificado y tiene el nombre especificado.Initializes a new instance of the DelimitedListTraceListener class that writes to the specified output stream and has the specified name.

DelimitedListTraceListener(String)

Inicializa una nueva instancia de la clase DelimitedListTraceListener que escribe en el archivo especificado.Initializes a new instance of the DelimitedListTraceListener class that writes to the specified file.

DelimitedListTraceListener(String, String)

Inicializa una nueva instancia de la clase DelimitedListTraceListener que escribe en el archivo especificado y tiene el nombre especificado.Initializes a new instance of the DelimitedListTraceListener class that writes to the specified file and has the specified name.

DelimitedListTraceListener(TextWriter)

Inicializa una nueva instancia de la clase DelimitedListTraceListener que escribe en el escritor de texto especificado.Initializes a new instance of the DelimitedListTraceListener class that writes to the specified text writer.

DelimitedListTraceListener(TextWriter, String)

Inicializa una nueva instancia de la clase DelimitedListTraceListener que escribe en el escritor de texto especificado y tiene el nombre especificado.Initializes a new instance of the DelimitedListTraceListener class that writes to the specified text writer and has the specified name.

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

(Heredado de TraceListener)
Delimiter

Obtiene o establece el delimitador de la lista delimitada.Gets or sets the delimiter for the delimited list.

Filter

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

(Heredado de TraceListener)
IndentLevel

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

(Heredado de TraceListener)
IndentSize

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

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

(Heredado de TraceListener)
Name

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

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

(Heredado de TraceListener)
TraceOutputOptions

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

(Heredado de TraceListener)
Writer

Obtiene o establece el escritor de texto que recibe los resultados de la traza o la depuración.Gets or sets the text writer that receives the tracing or debugging output.

(Heredado de TextWriterTraceListener)

Métodos

Close()

Cierra Writer para que ya no se reciba ningún resultado de la traza o la depuración.Closes the Writer so that it no longer receives tracing or debugging output.

(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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
Dispose()

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

(Heredado de TraceListener)
Dispose(Boolean)

Desecha este objeto TextWriterTraceListener.Disposes this TextWriterTraceListener object.

(Heredado de TextWriterTraceListener)
Equals(Object)

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

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

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

(Heredado de TraceListener)
Flush()

Vacía el búfer de resultados de la propiedad Writer.Flushes the output buffer for the Writer.

(Heredado de TextWriterTraceListener)
GetHashCode()

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

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

(Heredado de MarshalByRefObject)
GetSupportedAttributes()

Devuelve el atributo de archivo de configuración personalizado que admite el agente de escucha de seguimiento delimitado.Returns the custom configuration file attribute supported by the delimited trace listener.

GetType()

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

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

(Heredado de MarshalByRefObject)
MemberwiseClone()

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

(Heredado de Object)
MemberwiseClone(Boolean)

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

(Heredado de MarshalByRefObject)
ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(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.Writes trace information, a data object, and event information to the output file or stream.

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.Writes trace information, an array of data objects, and event information to the output file or stream.

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.

(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.Writes trace information, a message, and event information to the output file or stream.

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.Writes trace information, a formatted array of objects, and event information to the output file or stream.

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.

(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.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

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

(Heredado de TraceListener)
Write(String)

Escribe un mensaje en la propiedad Writer de esta instancia.Writes a message to this instance's Writer.

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

(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.Writes the indent to the listener you create when you implement this class, and resets the NeedIndent property to 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.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.

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

(Heredado de TraceListener)
WriteLine(String)

Escribe en la propiedad Writer de esta instancia un mensaje seguido de un terminador de línea.Writes a message to this instance's Writer followed by a line terminator. El terminador de línea predeterminado corresponde a un retorno de carro seguido de un avance de línea (\r\n).The default line terminator is a carriage return followed by a line feed (\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.Writes a category name and a message to the listener you create when you implement the TraceListener class, followed by a line terminator.

(Heredado de TraceListener)

Se aplica a