Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

TextWriterTraceListener (Clase)

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.

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

'Declaración
<HostProtectionAttribute(SecurityAction.LinkDemand, Synchronization := True)> _
Public Class TextWriterTraceListener _
	Inherits TraceListener

El tipo TextWriterTraceListener expone los siguientes miembros.

  NombreDescripción
Método públicoCompatible con XNA FrameworkTextWriterTraceListenerInicializa una nueva instancia de la clase TextWriterTraceListener con TextWriter como destinatario de resultados.
Método públicoCompatible con XNA FrameworkTextWriterTraceListener(Stream)Inicializa una nueva instancia de la clase TextWriterTraceListener utilizando la secuencia como destinatario de los resultados de la traza y la depuración.
Método públicoCompatible con XNA FrameworkTextWriterTraceListener(String)Inicializa una nueva instancia de la clase TextWriterTraceListener utilizando el archivo como destinatario de los resultados de la traza y la depuración.
Método públicoCompatible con XNA FrameworkTextWriterTraceListener(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.
Método públicoCompatible con XNA FrameworkTextWriterTraceListener(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.
Método públicoCompatible con XNA FrameworkTextWriterTraceListener(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.
Método públicoCompatible con XNA FrameworkTextWriterTraceListener(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.
Arriba

  NombreDescripción
Propiedad públicaAttributesObtiene los atributos de agente de escucha de seguimiento personalizados que están definidos en el archivo de configuración de la aplicación. (Se hereda de TraceListener).
Propiedad públicaFilterObtiene y establece el filtro de seguimiento para el agente de escucha de seguimiento. (Se hereda de TraceListener).
Propiedad públicaCompatible con XNA FrameworkIndentLevelObtiene o establece el nivel de sangría. (Se hereda de TraceListener).
Propiedad públicaCompatible con XNA FrameworkIndentSizeObtiene o establece el número de espacios de una sangría. (Se hereda de TraceListener).
Propiedad públicaIsThreadSafeObtiene un valor que indica si el agente de escucha de seguimiento es seguro para la ejecución de subprocesos. (Se hereda de TraceListener).
Propiedad públicaCompatible con XNA FrameworkNameObtiene o establece un nombre para este objeto TraceListener. (Se hereda de TraceListener).
Propiedad protegidaCompatible con XNA FrameworkNeedIndentObtiene o establece un valor que indica si se va a aplicar sangría a los resultados. (Se hereda de TraceListener).
Propiedad públicaTraceOutputOptionsObtiene o establece las opciones de los resultados de seguimiento. (Se hereda de TraceListener).
Propiedad públicaCompatible con XNA FrameworkWriterObtiene o establece el escritor de texto que recibe los resultados de la traza o la depuración.
Arriba

  NombreDescripción
Método públicoCompatible con XNA FrameworkCloseCierra Writer para que ya no se reciba ningún resultado de la traza o la depuración. (Invalida a TraceListener.Close).
Método públicoCreateObjRefCrea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject).
Método públicoCompatible con XNA FrameworkDisposeLibera todos los recursos utilizados por TraceListener. (Se hereda de TraceListener).
Método protegidoCompatible con XNA FrameworkDispose(Boolean)Infraestructura. Desecha este objeto TextWriterTraceListener. (Invalida a TraceListener.Dispose(Boolean)).
Método públicoCompatible con XNA FrameworkEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método públicoCompatible con XNA FrameworkFail(String)Emite un mensaje de error para el agente de escucha que se crea al implementar la clase TraceListener. (Se hereda de TraceListener).
Método públicoCompatible con XNA FrameworkFail(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. (Se hereda de TraceListener).
Método protegidoCompatible con XNA FrameworkFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoCompatible con XNA FrameworkFlushVacía el búfer de resultados de la propiedad Writer. (Invalida a TraceListener.Flush).
Método públicoCompatible con XNA FrameworkGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoGetLifetimeServiceRecupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegidoGetSupportedAttributesObtiene los atributos personalizados admitidos por el agente de escucha de seguimiento. (Se hereda de TraceListener).
Método públicoCompatible con XNA FrameworkGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoInitializeLifetimeServiceObtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegidoCompatible con XNA FrameworkMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoMemberwiseClone(Boolean)Crea una copia superficial del objeto MarshalByRefObject actual. (Se hereda de MarshalByRefObject).
Método públicoCompatible con XNA FrameworkToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Método públicoTraceData(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. (Se hereda de TraceListener).
Método públicoTraceData(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. (Se hereda de TraceListener).
Método públicoTraceEvent(TraceEventCache, String, TraceEventType, Int32)Escribe la información de seguimiento y de evento en los resultados específicos del agente de escucha. (Se hereda de TraceListener).
Método públicoTraceEvent(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. (Se hereda de TraceListener).
Método públicoTraceEvent(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. (Se hereda de TraceListener).
Método públicoTraceTransferEscribe 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. (Se hereda de TraceListener).
Método públicoCompatible con XNA FrameworkWrite(Object)Escribe el valor del método ToString del objeto en el agente de escucha que se crea al implementar la clase TraceListener. (Se hereda de TraceListener).
Método públicoCompatible con XNA FrameworkWrite(String)Escribe un mensaje en la propiedad Writer de esta instancia. (Invalida a TraceListener.Write(String)).
Método públicoCompatible con XNA FrameworkWrite(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. (Se hereda de TraceListener).
Método públicoCompatible con XNA FrameworkWrite(String, String)Escribe un nombre de categoría y un mensaje en el agente de escucha que se crea al implementar la clase TraceListener. (Se hereda de TraceListener).
Método protegidoCompatible con XNA FrameworkWriteIndentEscribe la sangría en el agente de escucha que se crea al implementar esta clase y restablece la propiedad NeedIndent en false. (Se hereda de TraceListener).
Método públicoCompatible con XNA FrameworkWriteLine(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. (Se hereda de TraceListener).
Método públicoCompatible con XNA FrameworkWriteLine(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). (Invalida a TraceListener.WriteLine(String)).
Método públicoCompatible con XNA FrameworkWriteLine(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. (Se hereda de TraceListener).
Método públicoCompatible con XNA FrameworkWriteLine(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. (Se hereda de TraceListener).
Arriba

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

Nota importanteImportante

Este tipo implementa la interfaz IDisposable. Cuando haya terminado de utilizar el tipo, se debe eliminar de directa o indirectamente. Para desechar de tipo directamente, llame al método de Dispose en un bloque de try/decatch . Para desechar de indirectamente, utilice una construcción de lenguaje como using (en C#) o Using (en Visual Basic). Para obtener más información, vea “Uso de objeto que implementa sección IDisposable” en el tema de la interfaz de IDisposable .

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

Es preciso habilitar la traza o la depuración para poder utilizar un agente de escucha de traza. 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 marcador /d:DEBUG a la línea de comandos del compilador, al compilar el código, o agregue #define DEBUG al principio del archivo. En Visual Basic, agregue el marcador /d:DEBUG=True a la línea de comandos del compilador.

  • Para habilitar la traza en C#, agregue el marcador /d:TRACE a la línea de comandos del compilador en el momento de compilar el código o bien agregue #define TRACE al principio del archivo. En Visual Basic, agregue el marcador /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).

NotaNota

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

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



.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos 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.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft