Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase TextWriterTraceListener

 

Publicado: julio de 2016

Dirige el seguimiento o la depuración a un TextWriter o un Stream, como FileStream.

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

System.Object
  System.MarshalByRefObject
    System.Diagnostics.TraceListener
      System.Diagnostics.TextWriterTraceListener
        System.Diagnostics.ConsoleTraceListener
        System.Diagnostics.DelimitedListTraceListener
        System.Diagnostics.EventSchemaTraceListener
        System.Diagnostics.XmlWriterTraceListener

[HostProtectionAttribute(SecurityAction.LinkDemand, Synchronization = true)]
public class TextWriterTraceListener : TraceListener

NombreDescripción
System_CAPS_pubmethodTextWriterTraceListener()

Inicializa una nueva instancia de la clase TextWriterTraceListener con TextWriter como receptor de la salida.

System_CAPS_pubmethodTextWriterTraceListener(Stream)

Inicializa una nueva instancia de la TextWriterTraceListener clase, utilizando la secuencia como destinatario de los resultados del seguimiento y la depuración.

System_CAPS_pubmethodTextWriterTraceListener(Stream, String)

Inicializa una nueva instancia de la TextWriterTraceListener clase con el nombre especificado, utilizando la secuencia como destinatario de la depuración y resultados de seguimiento.

System_CAPS_pubmethodTextWriterTraceListener(String)

Inicializa una nueva instancia de la TextWriterTraceListener clase, utilizando el archivo como destinatario de los resultados del seguimiento y la depuración.

System_CAPS_pubmethodTextWriterTraceListener(String, String)

Inicializa una nueva instancia de la TextWriterTraceListener clase con el nombre especificado, utilizando el archivo como destinatario de la depuración y resultados de seguimiento.

System_CAPS_pubmethodTextWriterTraceListener(TextWriter)

Inicializa una nueva instancia de la TextWriterTraceListener clase utilizando el escritor especificado como destinatario de la traza o la depuración de salida.

System_CAPS_pubmethodTextWriterTraceListener(TextWriter, String)

Inicializa una nueva instancia de la TextWriterTraceListener clase con el nombre especificado, utilizando el escritor especificado como destinatario de la traza o la depuración de salida.

NombreDescripción
System_CAPS_pubpropertyAttributes

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

System_CAPS_pubpropertyFilter

Obtiene y establece el filtro de seguimiento para el agente de escucha de seguimiento.(Heredado de TraceListener).

System_CAPS_pubpropertyIndentLevel

Obtiene o establece el nivel de sangría.(Heredado de TraceListener).

System_CAPS_pubpropertyIndentSize

Obtiene o establece el número de espacios de una sangría.(Heredado de TraceListener).

System_CAPS_pubpropertyIsThreadSafe

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

System_CAPS_pubpropertyName

Obtiene o establece un nombre para este objeto TraceListener.(Heredado de TraceListener).

System_CAPS_protpropertyNeedIndent

Obtiene o establece un valor que indica si se va a aplicar sangría a los resultados.(Heredado de TraceListener).

System_CAPS_pubpropertyTraceOutputOptions

Obtiene o establece las opciones de los resultados de seguimiento.(Heredado de TraceListener).

System_CAPS_pubpropertyWriter

Obtiene o establece el escritor de texto que recibe el seguimiento o la depuración de salida.

NombreDescripción
System_CAPS_pubmethodClose()

Cierra el Writer para que ya no recibe ningún seguimiento o de depuración de salida.(Invalida TraceListener.Close()).

System_CAPS_pubmethodCreateObjRef(Type)

Crea un objeto que contiene toda la información pertinente necesaria para generar a un proxy utilizado para comunicarse con un objeto remoto.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodDispose()

Libera todos los recursos usados por TraceListener.(Heredado de TraceListener).

System_CAPS_protmethodDispose(Boolean)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Elimina esta TextWriterTraceListener objeto.(Invalida TraceListener.Dispose(Boolean)).

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_pubmethodFail(String)

Emite un mensaje de error para el agente de escucha que se crea al implementar la clase TraceListener.(Heredado de TraceListener).

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

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodFlush()

Vacía el búfer de salida para el Writer.(Invalida TraceListener.Flush()).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_protmethodGetSupportedAttributes()

Obtiene los atributos personalizados admitidos por el agente de escucha de seguimiento.(Heredado de TraceListener).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodInitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_protmethodMemberwiseClone(Boolean)

Crea una copia superficial del actual MarshalByRefObject objeto.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodToString()

Retorna una cadena que representa al objeto actual. (Heredado de Object).

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

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

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

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

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

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

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

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

System_CAPS_pubmethodWrite(String)

Escribe un mensaje en esta instancia Writer.(Invalida TraceListener.Write(String)).

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

System_CAPS_protmethodWriteIndent()

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

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

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

System_CAPS_pubmethodWriteLine(String)

Escribe un mensaje en esta instancia Writer seguido de un terminador de línea. El terminador de línea predeterminado es un retorno de carro seguido de un avance de línea (\r\n).(Invalida TraceListener.WriteLine(String)).

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

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

System_CAPS_importantImportante

Este tipo implementa la IDisposable interfaz. Cuando haya terminado de utilizar el tipo, debería eliminar, directa o indirectamente. Para deshacerse del tipo directamente, llame a su Dispose método en un try/catch bloque. Para deshacerse de él indirectamente, usar una construcción de lenguaje como using (en C#) o Using (en Visual Basic). Para obtener más información, consulte la sección "Uso de un objeto que implementa IDisposable" en el IDisposable tema de la interfaz.

Esta clase también proporciona métodos para Close la Writer para que ya no recibe ningún seguimiento o de depuración de salida, a Flush el búfer de salida para el Writer, y Write un mensaje a la Writer.

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 utiliza compiladores distintos de C# o Visual Basic, consulte la documentación del compilador.

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

  • Para habilitar el seguimiento en C#, agregue el /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 el /d:TRACE=True marca 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 este archivo, puede agregar un agente de escucha, 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 se debe dar formato como en el 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>
System_CAPS_noteNota

Si intenta escribir en un archivo que está en uso o no está disponible, el nombre de archivo automáticamente viene precedido por un GUID.

En el ejemplo siguiente se implementa una instancia de la TextWriterTraceListener clase que utiliza un StreamWriter llama myOutputWriter para escribir en un archivo denominado TestFile.txt. El ejemplo crea primero un archivo de salida. A continuación, crea el StreamWriter para el primer escritor de texto, le asigna el archivo de salida y lo agrega a la 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.

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;
 }

}

.NET Framework
Disponible desde 1.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: