TextWriterTraceListener Clase

Definición

Dirige los resultados de la traza o la depuración a un objeto TextWriter o a un objeto de la clase Stream como un archivo FileStream.Directs tracing or debugging output to a TextWriter or to a Stream, such as FileStream.

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

Ejemplos

En el ejemplo siguiente se implementa una instancia de TextWriterTraceListener la clase que utiliza StreamWriter una myOutputWriter llamada para escribir en un archivo TestFile.txtdenominado.The following example implements an instance of the TextWriterTraceListener class that uses a StreamWriter called myOutputWriter to write to a file named TestFile.txt. En primer lugar, el ejemplo crea un archivo para la salida.First the example creates a file for output. A continuación, crea StreamWriter para el primer escritor de texto, le asigna el archivo de salida y lo agrega Listenersa.Then it creates the StreamWriter for the first text writer, assigns it the output file, and adds it to the Listeners. A continuación, el código genera una línea de texto en el archivo.Then, the code outputs one line of text to the file. Por último, en el ejemplo se vacía el búfer de salida.Finally, the example flushes the output buffer.

Después de ejecutar este ejemplo, puede abrir el TestFile.txt archivo para ver el resultado.After running this sample, you can open the TestFile.txt file to see the output.

void main()
{
   #if defined(TRACE)
   // Create a file for output named TestFile.txt.
   Stream^ myFile = File::Create( "TestFile.txt" );
   
   // Create a new text writer using the output stream and
   // add it to the trace listeners.
   TextWriterTraceListener^ myTextListener = 
      gcnew TextWriterTraceListener( myFile );
   Trace::Listeners->Add( myTextListener );
  
   // Write output to the file.
   Trace::Write( "Test output " );
  
   // Flush the output.
   Trace::Flush();
   Trace::Close();
   #endif
}
public class Sample
{

public static int Main(string[] args) {
    // Create a file for output named TestFile.txt.
    Stream myFile = File.Create("TestFile.txt");
 
    /* Create a new text writer using the output stream, and add it to
     * the trace listeners. */
    TextWriterTraceListener myTextListener = new 
       TextWriterTraceListener(myFile);
    Trace.Listeners.Add(myTextListener);
 
    // Write output to the file.
    Trace.Write("Test output ");
 

    // Flush the output.
    Trace.Flush(); 

    return 0;
 }

}
Public Class Sample
    
    Public Shared Sub Main()
        ' Create a file for output named TestFile.txt.
        Dim myFile As Stream = File.Create("TestFile.txt")
        
        ' Create a new text writer using the output stream, and add it to
        ' the trace listeners. 
        Dim myTextListener As New TextWriterTraceListener(myFile)
        Trace.Listeners.Add(myTextListener)

        
        ' Write output to the file.
        Trace.Write("Test output ")
        
        ' Flush the output.
        Trace.Flush() 

        System.Environment.ExitCode = 0
    End Sub

End Class

Comentarios

La TextWriterTraceListener clase proporciona la Writer propiedad para obtener o establecer el escritor de texto que recibe el resultado de la traza o la depuración.The TextWriterTraceListener class provides the Writer property to get or set the text writer that receives the tracing or debugging output.

Importante

Este tipo implementa la interfaz IDisposable.This type implements the 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 un bloque try/catch.To dispose of the type directly, call its Dispose method in a try/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.

Esta clase también proporciona métodos para Close Writer que ya no reciba resultados de la traza o de la depuración Flush , en el búfer de Writersalida del y Write en un mensaje a Writer.This class also provides methods to Close the Writer so that it no longer receives tracing or debugging output, to Flush the output buffer for the Writer, and to Write a message to the Writer.

Debe habilitar el seguimiento 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 utiliza compiladores distintos 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#, /d:DEBUG agregue la marca a la línea de comandos del compilador al compilar #define DEBUG el código o puede agregarlo 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 la /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 C#en, agregue /d:TRACE la marca a la línea de comandos del compilador al compilar el código o agregue #define TRACE en 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 la /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. 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 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 debe tener el formato del siguiente ejemplo.The configuration file should be formatted like 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>  

Nota

Si se realiza un intento de escribir en un archivo que está en uso o no disponible, el nombre de archivo se antepone automáticamente a un GUID.If an attempt is made to write to a file that is in use or unavailable, the file name is automatically prefixed by a GUID.

Constructores

TextWriterTraceListener()

Inicializa una nueva instancia de la clase TextWriterTraceListener con TextWriter como destinatario de resultados.Initializes a new instance of the TextWriterTraceListener class with TextWriter as the output recipient.

TextWriterTraceListener(Stream)

Inicializa una nueva instancia de la clase TextWriterTraceListener utilizando la secuencia como destinatario de los resultados de la traza y la depuración.Initializes a new instance of the TextWriterTraceListener class, using the stream as the recipient of the debugging and tracing output.

TextWriterTraceListener(Stream, String)

Inicializa una nueva instancia de la clase TextWriterTraceListener con el nombre especificado, utilizando la secuencia como destinatario de los resultados de la traza y la depuración.Initializes a new instance of the TextWriterTraceListener class with the specified name, using the stream as the recipient of the debugging and tracing output.

TextWriterTraceListener(String)

Inicializa una nueva instancia de la clase TextWriterTraceListener utilizando el archivo como destinatario de los resultados de la traza y la depuración.Initializes a new instance of the TextWriterTraceListener class, using the file as the recipient of the debugging and tracing output.

TextWriterTraceListener(String, String)

Inicializa una nueva instancia de la clase TextWriterTraceListener con el nombre especificado, utilizando el archivo como destinatario de los resultados de la traza y la depuración.Initializes a new instance of the TextWriterTraceListener class with the specified name, using the file as the recipient of the debugging and tracing output.

TextWriterTraceListener(TextWriter)

Inicializa una nueva instancia de la clase TextWriterTraceListener utilizando el escritor especificado como destinatario de los resultados de la traza o la depuración.Initializes a new instance of the TextWriterTraceListener class using the specified writer as recipient of the tracing or debugging output.

TextWriterTraceListener(TextWriter, String)

Inicializa una nueva instancia de la clase TextWriterTraceListener con el nombre especificado, utilizando el escritor como destinatario de los resultados de la traza o la depuración.Initializes a new instance of the TextWriterTraceListener class with the specified name, using the specified writer as recipient of the tracing or debugging output.

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

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.

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.

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.

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

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

(Heredado de TraceListener)
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 los resultados específicos del agente de escucha.Writes trace information, a data object and event information to the listener specific output.

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

(Heredado de TraceListener)
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 los resultados específicos del agente de escucha.Writes trace information, a message, and event information to the listener specific output.

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

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

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

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

Consulte también: