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 TextWriter

 

Publicado: octubre de 2016

Representa un sistema de escritura que puede escribir una serie secuencial de caracteres. Esta clase es abstracta.

Espacio de nombres:   System.IO
Ensamblado:  mscorlib (en mscorlib.dll)


[SerializableAttribute]
[ComVisibleAttribute(true)]
public abstract class TextWriter : MarshalByRefObject, IDisposable

NombreDescripción
System_CAPS_protmethodTextWriter()

Inicializa una nueva instancia de la clase TextWriter.

System_CAPS_protmethodTextWriter(IFormatProvider)

Inicializa una nueva instancia de la clase TextWriter con el control de formato especificado.

NombreDescripción
System_CAPS_pubpropertyEncoding

Cuando se reemplaza en una clase derivada, devuelve la codificación de caracteres en que se escribe el resultado.

System_CAPS_pubpropertyFormatProvider

Obtiene un objeto que controla las operaciones de formato.

System_CAPS_pubpropertyNewLine

Obtiene o establece la cadena de terminador de línea usada por el TextWriter actual.

NombreDescripción
System_CAPS_pubmethodClose()

Cierra el sistema de escritura actual y libera todos los recursos del sistema asociados al sistema de escritura.

System_CAPS_pubmethodCreateObjRef(Type)

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

System_CAPS_pubmethodDispose()

Libera todos los recursos utilizados por el objeto TextWriter.

System_CAPS_protmethodDispose(Boolean)

Libera los recursos no administrados que usa TextWriter y libera los recursos administrados de forma opcional.

System_CAPS_pubmethodEquals(Object)

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

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

Borra todos los búferes del sistema de escritura actual y hace que todos los datos almacenados en el búfer se escriban en el dispositivo subyacente.

System_CAPS_pubmethodFlushAsync()

Borra asincrónicamente todos los búferes del sistema de escritura actual y hace que todos los datos almacenados en el búfer se escriban en el dispositivo subyacente.

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_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 elemento actual MarshalByRefObject objeto.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodSystem_CAPS_staticSynchronized(TextWriter)

Crea un contenedor seguro para subprocesos en torno al TextWriter especificado.

System_CAPS_pubmethodToString()

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

System_CAPS_pubmethodWrite(Boolean)

Escribe la representación de texto de un valor Boolean en la cadena o secuencia de texto.

System_CAPS_pubmethodWrite(Char)

Escribe un carácter en la cadena o secuencia de texto.

System_CAPS_pubmethodWrite(Char[])

Escribe una matriz de caracteres en la cadena o secuencia de texto.

System_CAPS_pubmethodWrite(Char[], Int32, Int32)

Escribe una submatriz de caracteres en la cadena o secuencia de texto.

System_CAPS_pubmethodWrite(Decimal)

Escribe la representación de texto de un valor decimal en la cadena o secuencia de texto.

System_CAPS_pubmethodWrite(Double)

Escribe la representación de texto de un valor de punto flotante de 8 bytes en la cadena o secuencia de texto.

System_CAPS_pubmethodWrite(Int32)

Escribe la representación de texto de un entero con signo de 4 bytes en la cadena o secuencia de texto.

System_CAPS_pubmethodWrite(Int64)

Escribe la representación de texto de un entero con signo de 8 bytes en la cadena o secuencia de texto.

System_CAPS_pubmethodWrite(Object)

Escribe la representación de texto de un objeto en la cadena o secuencia de texto mediante una llamada al método ToString en ese objeto.

System_CAPS_pubmethodWrite(Single)

Escribe la representación de texto de un valor de punto flotante de 4 bytes en la cadena o secuencia de texto.

System_CAPS_pubmethodWrite(String)

Escribe una cadena en la cadena o secuencia de texto.

System_CAPS_pubmethodWrite(String, Object)

Escribe una cadena con formato en la cadena de texto o en la secuencia, con la misma semántica que el método de String.Format(String, Object).

System_CAPS_pubmethodWrite(String, Object, Object)

Escribe una cadena con formato en la cadena de texto o en la secuencia, con la misma semántica que el método de String.Format(String, Object, Object).

System_CAPS_pubmethodWrite(String, Object, Object, Object)

Escribe una cadena con formato en la cadena de texto o en la secuencia, con la misma semántica que el método de String.Format(String, Object, Object, Object).

System_CAPS_pubmethodWrite(String, Object[])

Escribe una cadena con formato en la cadena de texto o en la secuencia, con la misma semántica que el método de String.Format(String, Object[]).

System_CAPS_pubmethodWrite(UInt32)

Escribe la representación de texto de un entero sin signo de 4 bytes en la cadena o secuencia de texto.

System_CAPS_pubmethodWrite(UInt64)

Escribe la representación de texto de un entero sin signo de 8 bytes en la cadena o secuencia de texto.

System_CAPS_pubmethodWriteAsync(Char)

Escribe un carácter en la cadena o secuencia de texto de forma asincrónica.

System_CAPS_pubmethodWriteAsync(Char[])

Escribe una matriz de caracteres en la cadena o secuencia de texto de forma asincrónica.

System_CAPS_pubmethodWriteAsync(Char[], Int32, Int32)

Escribe una submatriz de caracteres en la cadena o secuencia de texto de forma asincrónica.

System_CAPS_pubmethodWriteAsync(String)

Escribe una cadena en la cadena o secuencia de texto de forma asincrónica.

System_CAPS_pubmethodWriteLine()

Escribe un terminador de línea en la cadena o secuencia.

System_CAPS_pubmethodWriteLine(Boolean)

Escribe la representación de texto de un valor Boolean seguida de un terminador de línea en la cadena o secuencia de texto.

System_CAPS_pubmethodWriteLine(Char)

Escribe un carácter seguido de un terminador en la cadena o la secuencia de texto.

System_CAPS_pubmethodWriteLine(Char[])

Escribe una matriz de caracteres seguida de un terminador de línea en la cadena o secuencia de texto.

System_CAPS_pubmethodWriteLine(Char[], Int32, Int32)

Escribe una submatriz de caracteres seguida de un terminador de línea en la cadena o secuencia de texto.

System_CAPS_pubmethodWriteLine(Decimal)

Escribe la representación de texto de un valor decimal seguida de un terminador de línea en la cadena o secuencia de texto.

System_CAPS_pubmethodWriteLine(Double)

Escribe la representación de texto de un valor de punto flotante de 8 bytes seguida de un terminador de línea en la cadena o secuencia de texto.

System_CAPS_pubmethodWriteLine(Int32)

Escribe la representación de texto de un entero con signo de 4 bytes seguida de un terminador de línea en la cadena o secuencia de texto.

System_CAPS_pubmethodWriteLine(Int64)

Escribe la representación de texto de un entero con signo de 8 bytes seguida de un terminador de línea en la cadena o secuencia de texto.

System_CAPS_pubmethodWriteLine(Object)

Escribe la representación de texto de un objeto mediante una llamada al método ToString en ese objeto, seguida de un terminador de línea en la cadena o secuencia de texto.

System_CAPS_pubmethodWriteLine(Single)

Escribe la representación de texto de un valor de punto flotante de 4 bytes seguida de un terminador de línea en la cadena o secuencia de texto.

System_CAPS_pubmethodWriteLine(String)

Escribe una cadena seguida de un terminador en la cadena o la secuencia de texto.

System_CAPS_pubmethodWriteLine(String, Object)

Escribe una cadena con formato y una nueva línea en la cadena de texto o a la secuencia, con la misma semántica que el método de String.Format(String, Object).

System_CAPS_pubmethodWriteLine(String, Object, Object)

Escribe una cadena con formato y una nueva línea en la cadena de texto o a la secuencia, con la misma semántica que el método de String.Format(String, Object, Object).

System_CAPS_pubmethodWriteLine(String, Object, Object, Object)

Escribe una cadena con formato y una nueva línea usando la misma semántica que Format.

System_CAPS_pubmethodWriteLine(String, Object[])

Escribe una cadena con formato y una nueva línea usando la misma semántica que Format.

System_CAPS_pubmethodWriteLine(UInt32)

Escribe la representación de texto de un entero sin signo de 4 bytes seguida de un terminador de línea en la cadena o secuencia de texto.

System_CAPS_pubmethodWriteLine(UInt64)

Escribe la representación de texto de un entero sin signo de 8 bytes seguida de un terminador de línea en la cadena o secuencia de texto.

System_CAPS_pubmethodWriteLineAsync()

Escribe un terminador de línea en la cadena o secuencia de forma asincrónica.

System_CAPS_pubmethodWriteLineAsync(Char)

Escribe un carácter seguido de un terminador de forma asincrónica en la cadena o la secuencia de texto.

System_CAPS_pubmethodWriteLineAsync(Char[])

Escribe una matriz de caracteres seguida de un terminador de línea de forma asincrónica en la cadena o secuencia de texto.

System_CAPS_pubmethodWriteLineAsync(Char[], Int32, Int32)

Escribe una submatriz de caracteres seguida de un terminador de línea de forma asincrónica en la cadena o secuencia de texto.

System_CAPS_pubmethodWriteLineAsync(String)

Escribe una cadena seguido de un terminador de forma asincrónica en la cadena o la secuencia de texto.

NombreDescripción
System_CAPS_protfieldCoreNewLine

Almacena los caracteres de nueva línea usados para el TextWriter.

System_CAPS_pubfieldSystem_CAPS_staticNull

Proporciona un TextWriter sin memoria auxiliar, en el que se puede escribir pero no se puede leer.

TextWriter es la clase base abstracta de StreamWriter y StringWriter, que escriben caracteres en secuencias y cadenas, respectivamente. Cree una instancia de TextWriter para escribir un objeto en una cadena, escribir cadenas en un archivo o serializar XML. También puede utilizar una instancia de TextWriter para escribir texto en un almacén de respaldo personalizado utilizando las mismas API que utilizaría para una cadena o una secuencia, o para agregar compatibilidad con el formato de texto.

Todos los Write métodos de TextWriter con tipos de datos primitivos como parámetros escriben los valores como cadenas.

De forma predeterminada, un TextWriter no es seguro para la ejecución de subprocesos. Consulte TextWriter.Synchronized para un contenedor seguro para subprocesos.

System_CAPS_importantImportante

Este tipo implementa la IDisposable interfaz. Cuando haya terminado de utilizar cualquier tipo que se deriva este 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 Dispose y la sección "Uso de un objeto que implementa IDisposable" en el IDisposable tema de la interfaz.

Para obtener una lista de tareas de E/S comunes, consulte Tareas de E/S comunes.

Notas para desarrolladores de herederos:

Una clase derivada debe implementar la TextWriter.Write(Char) método para crear una instancia útil de TextWriter.

La clase TextWriter es abstracta. Por lo tanto, no inicializarlo en el código. La StreamWriter clase se deriva de TextWriter y proporciona implementaciones de los miembros para escribir una secuencia. En el ejemplo siguiente se muestra cómo escribir dos líneas que consisten en valores de cadena en un archivo de texto utilizando la WriteLineAsync(String) (método).

Reemplace Dispose en una clase derivada para proporcionar

using System;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            using (StreamWriter writer = File.CreateText("newfile.txt"))
            {
                await writer.WriteLineAsync("First line of example");
                await writer.WriteLineAsync("and second line");
            }
        }
    }
}

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.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: