Exportar (0) Imprimir
Expandir todo
Este tema aún no ha recibido ninguna valoración - Valorar este tema

TextWriterTraceListener (Clase)

Dirige los resultados del seguimiento o la depuración a un objeto TextWriter o a un objeto de la clase Stream como un archivo FileStream.

Espacio de nombres: System.Diagnostics
Ensamblado: System (en system.dll)

public class TextWriterTraceListener : TraceListener
public class TextWriterTraceListener extends TraceListener
public class TextWriterTraceListener extends TraceListener
NotaNota

El atributo HostProtectionAttribute aplicado a esta clase tiene el siguiente valor para la propiedad Resources: Synchronization. HostProtectionAttribute no afecta a las aplicaciones de escritorio (que normalmente se inician al hacer doble clic en un icono, escribir un comando o introducir una dirección URL en un explorador). Para obtener más información, vea la clase HostProtectionAttribute o Programación de SQL Server y atributos de protección del host.

La clase TextWriterTraceListener proporciona la propiedad Writer para obtener o establecer el escritor de texto que recibe los resultados del seguimiento o la depuración.

Esta clase también proporciona métodos para Close (cerrar) el escritor Writer de modo que ya no reciba los resultados del seguimiento o la depuración, para Flush (vaciar) el búfer de resultados del escritor Writer y para Write (escribir) un mensaje al Writer (escritor).

Debe habilitar el seguimiento o la depuración para utilizar un agente de escucha de seguimiento. La sintaxis siguiente es específica del compilador. Si se utilizan compiladores que no sean C# o Visual Basic, consulte la documentación del compilador.

  • Para habilitar la depuración en C#, agregue el indicador /d:DEBUG a la línea de comandos del compilador en el momento de compilar el código o agregue #define DEBUG al principio del archivo. En Visual Basic, agregue el indicador /d:DEBUG=True a la línea de comandos del compilador.

  • Para habilitar el seguimiento en C#, agregue el indicador /d:TRACE a la línea de comandos del compilador en el momento de compilar el código o agregue #define TRACE al principio del archivo. En Visual Basic, agregue el indicador /d:TRACE=True a la línea de comandos del compilador.

Para agregar un agente de escucha de seguimiento, modifique el archivo de configuración que corresponde al nombre de la aplicación. En el archivo se puede agregar un agente de escucha y establecer su tipo y 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 debería tener el formato que se muestra en el siguiente ejemplo.

<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>
NotaNota

Si se intenta escribir en un archivo que está en uso o no está disponible, delante del nombre del archivo se agrega automáticamente un identificador único global (GUID).

En el ejemplo siguiente se implementa una instancia de la clase TextWriterTraceListener que utiliza un objeto StreamWriter denominado myOutputWriter para escribir en un archivo denominado TestFile.txt. En primer lugar, se crea un archivo para los resultados. A continuación, se crea el objeto StreamWriter para el primer escritor de texto, se le asigna el archivo de resultados y se agrega a la propiedad Listeners. A continuación, el código escribe una línea de texto en el archivo. Finalmente, el ejemplo vacía el búfer de salida.

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

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 static void 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.get_Listeners().Add(myTextListener);

        // Write output to the file.
        Trace.Write("Test output ");

        // Flush the output.
        Trace.Flush();
        return;
    } //main
} //Sample 

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 SP4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

Compatible con: 2.0, 1.1, 1.0
¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft. Reservados todos los derechos.