TextWriterTraceListener Clase

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Diagnostics.TextWriterTraceListener.dll

Source:

TextWriterTraceListener.cs

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.

public ref class TextWriterTraceListener : System::Diagnostics::TraceListener

public class TextWriterTraceListener : System.Diagnostics.TraceListener

type TextWriterTraceListener = class
    inherit TraceListener

Public Class TextWriterTraceListener
Inherits TraceListener

Herencia

Object

MarshalByRefObject

TraceListener

TextWriterTraceListener

Derivado

System.Diagnostics.ConsoleTraceListener

System.Diagnostics.DelimitedListTraceListener

System.Diagnostics.EventSchemaTraceListener

System.Diagnostics.XmlWriterTraceListener

Ejemplos

En el ejemplo siguiente se implementa una instancia de la TextWriterTraceListener clase que usa un StreamWriter llamado myOutputWriter para escribir en un archivo denominado TestFile.txt. En primer lugar, el ejemplo crea un archivo para la salida. A continuación, crea para StreamWriter el primer escritor de texto, le asigna el archivo de salida y lo agrega a Listeners. A continuación, el código genera una línea de texto en el archivo. Por último, el ejemplo vacía el búfer de salida.

Después de ejecutar este ejemplo, puede abrir el TestFile.txt archivo para ver la salida.

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 la salida de seguimiento o depuración.

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 método Dispose en un bloque try/catch. 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.

Esta clase también proporciona métodos para WriterClose que ya no reciba la salida de seguimiento o depuración, al Flush búfer de salida de Writery a Write un mensaje a .Writer

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 bien puede agregarla #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 en una aplicación de .NET Framework, 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 previamente establecidos por la aplicación. El archivo de configuración debe tener 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>  

Nota

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

Constructores

TextWriterTraceListener()	Inicializa una nueva instancia de la clase TextWriterTraceListener con TextWriter como receptor de la salida.
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.
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.
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.
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.
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.
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.

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

Métodos

Close()	Cierra Writer para que ya no se reciba ningún resultado de la traza o la depuración.
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.
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.
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()	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 los resultados específicos del agente de escucha. (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. (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. (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. (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. (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. (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.
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).
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)

Consulte también

• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• Stream
• TextWriter
• Debug
• Trace