TextWriter Clase

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

Source:

TextWriter.cs

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

public ref class TextWriter abstract : MarshalByRefObject, IAsyncDisposable, IDisposable

public abstract class TextWriter : MarshalByRefObject, IAsyncDisposable, IDisposable

type TextWriter = class
    inherit MarshalByRefObject
    interface IAsyncDisposable
    interface IDisposable

Public MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDisposable

Herencia

Object

MarshalByRefObject

TextWriter

Derivado

System.CodeDom.Compiler.IndentedTextWriter

System.IO.StreamWriter

System.IO.StringWriter

System.Web.HttpWriter

System.Web.UI.HtmlTextWriter

Implementaciones

IDisposable IAsyncDisposable

Ejemplos

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

using System.IO;

namespace ConsoleApplication
{
    class Program4
    {
        static void Main()
        {
            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");
            }
        }
    }
}

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Using writer As StreamWriter = File.CreateText("newfile.txt")
            Await writer.WriteLineAsync("First line of example")
            Await writer.WriteLineAsync("and second line")
        End Using
    End Sub
End Module

Comentarios

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

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

De forma predeterminada, un TextWriter no es seguro para subprocesos. Consulte TextWriter.Synchronized para obtener un contenedor seguro para subprocesos.

Importante

Este tipo implementa la interfaz IDisposable. Cuando haya terminado de usar cualquier tipo que derive de este tipo, debe eliminarlo directa o indirectamente. Para eliminar el tipo directamente, llame a su método Dispose en un bloque try/catch. Para eliminarlo indirectamente, use una construcción de lenguaje como using (en C#) o Using (en Visual Basic). Para obtener más información, vea Dispose y la sección "Using an Object that Implements IDisposable" (Usar un objeto que implementa IDisposable) en el tema de la interfaz de IDisposable.

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

Notas a los implementadores

Una clase derivada debe implementar mínimamente el método Write(Char) para que una instancia útil de TextWriter.

Constructores

TextWriter()	Inicializa una nueva instancia de la clase TextWriter.
TextWriter(IFormatProvider)	Inicializa una nueva instancia de la clase TextWriter con el proveedor de formato especificado.

Campos

CoreNewLine	Almacena los caracteres de nueva línea usados para este TextWriter.
Null	Proporciona un TextWriter sin memoria auxiliar en la que se puede escribir, pero no leer desde.

Propiedades

Encoding	Cuando se reemplaza en una clase derivada, devuelve la codificación de caracteres en la que se escribe la salida.
FormatProvider	Obtiene un objeto que controla el formato.
NewLine	Obtiene o establece la cadena de terminador de línea usada por el TextWriteractual.

Métodos

Close()	Cierra el escritor actual y libera los recursos del sistema asociados al escritor.
CreateObjRef(Type)	Crea un objeto que contiene toda la información pertinente necesaria para generar un proxy usado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Dispose()	Libera todos los recursos utilizados por el objeto TextWriter.
Dispose(Boolean)	Libera los recursos no administrados usados por el TextWriter y, opcionalmente, libera los recursos administrados.
DisposeAsync()	Libera de forma asincrónica todos los recursos utilizados por el objeto TextWriter.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
Flush()	Borra todos los búferes del escritor actual y hace que los datos almacenados en búfer se escriban en el dispositivo subyacente.
FlushAsync()	Borra de forma asincrónica todos los búferes del escritor actual y hace que los datos almacenados en búfer se escriban en el dispositivo subyacente.
FlushAsync(CancellationToken)	Borra de forma asincrónica todos los búferes del escritor actual y hace que los datos almacenados en búfer se escriban en el dispositivo subyacente.
GetHashCode()	Actúa como 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)
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 Objectactual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
Synchronized(TextWriter)	Crea un contenedor seguro para subprocesos alrededor del TextWriterespecificado.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
Write(Boolean)	Escribe la representación de texto de un valor de Boolean en la secuencia de texto.
Write(Char)	Escribe un carácter en la secuencia de texto.
Write(Char[])	Escribe una matriz de caracteres en la secuencia de texto.
Write(Char[], Int32, Int32)	Escribe una subbarra de caracteres en la secuencia de texto.
Write(Decimal)	Escribe la representación de texto de un valor decimal en la secuencia de texto.
Write(Double)	Escribe la representación de texto de un valor de punto flotante de 8 bytes en la secuencia de texto.
Write(Int32)	Escribe la representación de texto de un entero con signo de 4 bytes en la secuencia de texto.
Write(Int64)	Escribe la representación de texto de un entero con signo de 8 bytes en la secuencia de texto.
Write(Object)	Escribe la representación de texto de un objeto en la secuencia de texto llamando al método ToString en ese objeto.
Write(ReadOnlySpan<Char>)	Escribe un intervalo de caracteres en la secuencia de texto.
Write(Single)	Escribe la representación de texto de un valor de punto flotante de 4 bytes en la secuencia de texto.
Write(String)	Escribe una cadena en la secuencia de texto.
Write(String, Object)	Escribe una cadena con formato en la secuencia de texto, utilizando la misma semántica que el método Format(String, Object).
Write(String, Object, Object)	Escribe una cadena con formato en la secuencia de texto con la misma semántica que el método Format(String, Object, Object).
Write(String, Object, Object, Object)	Escribe una cadena con formato en la secuencia de texto, utilizando la misma semántica que el método Format(String, Object, Object, Object).
Write(String, Object[])	Escribe una cadena con formato en la secuencia de texto, utilizando la misma semántica que el método Format(String, Object[]).
Write(StringBuilder)	Escribe un generador de cadenas en la secuencia de texto.
Write(UInt32)	Escribe la representación de texto de un entero de 4 bytes sin signo en la secuencia de texto.
Write(UInt64)	Escribe la representación de texto de un entero de 8 bytes sin signo en la secuencia de texto.
WriteAsync(Char)	Escribe un carácter en la secuencia de texto de forma asincrónica.
WriteAsync(Char[])	Escribe una matriz de caracteres en la secuencia de texto de forma asincrónica.
WriteAsync(Char[], Int32, Int32)	Escribe una subbarra de caracteres en la secuencia de texto de forma asincrónica.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	Escribe de forma asincrónica una región de memoria de caracteres en la secuencia de texto.
WriteAsync(String)	Escribe una cadena en la secuencia de texto de forma asincrónica.
WriteAsync(StringBuilder, CancellationToken)	Escribe de forma asincrónica un generador de cadenas en la secuencia de texto.
WriteLine()	Escribe un terminador de línea en la secuencia de texto.
WriteLine(Boolean)	Escribe la representación de texto de un valor de Boolean en la secuencia de texto, seguida de un terminador de línea.
WriteLine(Char)	Escribe un carácter en la secuencia de texto, seguido de un terminador de línea.
WriteLine(Char[])	Escribe una matriz de caracteres en la secuencia de texto, seguida de un terminador de línea.
WriteLine(Char[], Int32, Int32)	Escribe una subbarra de caracteres en la secuencia de texto, seguida de un terminador de línea.
WriteLine(Decimal)	Escribe la representación de texto de un valor decimal en la secuencia de texto, seguida de un terminador de línea.
WriteLine(Double)	Escribe la representación de texto de un valor de punto flotante de 8 bytes en la secuencia de texto, seguida de un terminador de línea.
WriteLine(Int32)	Escribe la representación de texto de un entero con signo de 4 bytes en la secuencia de texto, seguido de un terminador de línea.
WriteLine(Int64)	Escribe la representación de texto de un entero con signo de 8 bytes en la secuencia de texto, seguido de un terminador de línea.
WriteLine(Object)	Escribe la representación de texto de un objeto en la secuencia de texto llamando al método ToString en ese objeto, seguido de un terminador de línea.
WriteLine(ReadOnlySpan<Char>)	Escribe la representación de texto de un intervalo de caracteres en la secuencia de texto, seguida de un terminador de línea.
WriteLine(Single)	Escribe la representación de texto de un valor de punto flotante de 4 bytes en la secuencia de texto, seguida de un terminador de línea.
WriteLine(String)	Escribe una cadena en la secuencia de texto, seguida de un terminador de línea.
WriteLine(String, Object)	Escribe una cadena con formato y una nueva línea en la secuencia de texto, utilizando la misma semántica que el método Format(String, Object).
WriteLine(String, Object, Object)	Escribe una cadena con formato y una nueva línea en la secuencia de texto, utilizando la misma semántica que el método Format(String, Object, Object).
WriteLine(String, Object, Object, Object)	Escribe una cadena con formato y una nueva línea en la secuencia de texto, con la misma semántica que Format(String, Object).
WriteLine(String, Object[])	Escribe una cadena con formato y una nueva línea en la secuencia de texto, con la misma semántica que Format(String, Object).
WriteLine(StringBuilder)	Escribe la representación de texto de un generador de cadenas en la secuencia de texto, seguida de un terminador de línea.
WriteLine(UInt32)	Escribe la representación de texto de un entero de 4 bytes sin signo en la secuencia de texto, seguida de un terminador de línea.
WriteLine(UInt64)	Escribe la representación de texto de un entero de 8 bytes sin signo en la secuencia de texto, seguida de un terminador de línea.
WriteLineAsync()	Escribe de forma asincrónica un terminador de línea en la secuencia de texto.
WriteLineAsync(Char)	Escribe de forma asincrónica un carácter en la secuencia de texto, seguido de un terminador de línea.
WriteLineAsync(Char[])	Escribe de forma asincrónica una matriz de caracteres en la secuencia de texto, seguida de un terminador de línea.
WriteLineAsync(Char[], Int32, Int32)	Escribe de forma asincrónica una subbarray de caracteres en la secuencia de texto, seguida de un terminador de línea.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Escribe de forma asincrónica la representación de texto de una región de memoria de caracteres en la secuencia de texto, seguida de un terminador de línea.
WriteLineAsync(String)	Escribe de forma asincrónica una cadena en la secuencia de texto, seguida de un terminador de línea.
WriteLineAsync(StringBuilder, CancellationToken)	Escribe de forma asincrónica la representación de texto de un generador de cadenas en la secuencia de texto, seguida de un terminador de línea.

Métodos de extensión

ConfigureAwait(IAsyncDisposable, Boolean)

Configura cómo se realizan las esperas en las tareas devueltas desde un descartable asincrónico.

Consulte también

• StreamWriter
• StringWriter
• de E/S de flujo y archivos
• Cómo: Leer texto de un de archivos
• Cómo: Escribir texto en un archivo
• Cómo: Leer y escribir en un archivo de datos recién creado