TextWriter Clase

Definición

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

public ref class TextWriter abstract : IDisposable
public ref class TextWriter abstract : MarshalByRefObject, IAsyncDisposable, IDisposable
public ref class TextWriter abstract : MarshalByRefObject, IDisposable
public abstract class TextWriter : IDisposable
public abstract class TextWriter : MarshalByRefObject, IAsyncDisposable, IDisposable
public abstract class TextWriter : MarshalByRefObject, IDisposable
[System.Serializable]
public abstract class TextWriter : MarshalByRefObject, IDisposable
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class TextWriter : MarshalByRefObject, IDisposable
type TextWriter = class
    interface IDisposable
type TextWriter = class
    inherit MarshalByRefObject
    interface IAsyncDisposable
    interface IDisposable
type TextWriter = class
    inherit MarshalByRefObject
    interface IDisposable
[<System.Serializable>]
type TextWriter = class
    inherit MarshalByRefObject
    interface IDisposable
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type TextWriter = class
    inherit MarshalByRefObject
    interface IDisposable
Public MustInherit Class TextWriter
Implements IDisposable
Public MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDisposable
Public MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IDisposable
Herencia
TextWriter
Herencia
Derivado
Atributos
Implementaciones

Ejemplos

La clase TextWriter es una clase abstracta. Por lo tanto, no se crea una instancia en el código. La StreamWriter clase 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 WriteLineAsync(String) método .

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 para 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 Write métodos de tener tipos de TextWriter datos primitivos como parámetros escriben los valores como cadenas.

De forma predeterminada, no TextWriter 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 deshacerse de él 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 IDisposable interfaz.

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

Notas a los implementadores

Una clase derivada debe implementar mínimamente el Write(Char) método para que sea 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 control de formato especificado.

Campos

CoreNewLine

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

Null

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

Propiedades

Encoding

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

FormatProvider

Obtiene un objeto que controla las operaciones de formato.

NewLine

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

Métodos

Close()

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

CreateBroadcasting(TextWriter[])

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

CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado 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 que usa TextWriter y, de forma opcional, libera los recursos administrados.

DisposeAsync()

Libera de forma asincrónica todos los recursos que usa el objeto TextWriter.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
Flush()

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.

FlushAsync()

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.

FlushAsync(CancellationToken)

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.

GetHashCode()

Sirve como la 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 Object actual.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.

(Heredado de MarshalByRefObject)
Synchronized(TextWriter)

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

ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
Write(Boolean)

Escribe la representación de texto de un valor 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 submatriz 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 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 mediante una llamada 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 con 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 con 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 con 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 sin signo de 4 bytes en la secuencia de texto.

Write(UInt64)

Escribe la representación de texto de un entero sin signo de 8 bytes 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 submatriz de caracteres en la secuencia de texto de forma asincrónica.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Escribe una región de la memoria de caracteres en la secuencia de texto de forma asincrónica.

WriteAsync(String)

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

WriteAsync(StringBuilder, CancellationToken)

Escribe un generador de cadenas en la secuencia de texto de forma asincrónica.

WriteLine()

Escribe un terminador de línea en la secuencia de texto.

WriteLine(Boolean)

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

WriteLine(Char)

Escribe un carácter seguido de un terminador de línea en la secuencia de texto.

WriteLine(Char[])

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

WriteLine(Char[], Int32, Int32)

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

WriteLine(Decimal)

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

WriteLine(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 secuencia de texto.

WriteLine(Int32)

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

WriteLine(Int64)

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

WriteLine(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 secuencia de texto.

WriteLine(ReadOnlySpan<Char>)

Escribe la representación de texto de un intervalo de caracteres seguida de un terminador de línea en la secuencia de texto.

WriteLine(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 secuencia de texto.

WriteLine(String)

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

WriteLine(String, Object)

Escribe una cadena con formato y una nueva línea en la secuencia de texto con 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 con la misma semántica que el método Format(String, Object, Object).

WriteLine(String, Object, Object, Object)

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

WriteLine(String, Object[])

Escribe una cadena con formato y una línea nueva 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 seguida de un terminador de línea en la secuencia de texto.

WriteLine(UInt32)

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

WriteLine(UInt64)

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

WriteLineAsync()

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

WriteLineAsync(Char)

Escribe un carácter seguido de un terminador de línea en la secuencia de texto de forma asincrónica.

WriteLineAsync(Char[])

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

WriteLineAsync(Char[], Int32, Int32)

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

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Escribe la representación de texto de una región de memoria de caracteres seguida de un terminador de línea en la secuencia de texto de forma asincrónica.

WriteLineAsync(String)

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

WriteLineAsync(StringBuilder, CancellationToken)

Escribe la representación de texto de un generador de cadenas seguida de un terminador de línea en la secuencia de texto de forma asincrónica.

Implementaciones de interfaz explícitas

IDisposable.Dispose()

Para obtener una descripción de este miembro, vea Dispose().

Métodos de extensión

ConfigureAwait(IAsyncDisposable, Boolean)

Configura la forma en la que se realizan las expresiones await en las tareas devueltas desde un elemento asincrónico descartable.

Se aplica a

Consulte también