TextWriter TextWriter TextWriter TextWriter Class

Definición

Representa un sistema de escritura que puede escribir una serie secuencial de caracteres.Represents a writer that can write a sequential series of characters. Esta clase es abstracta.This class is abstract.

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

Ejemplos

La clase TextWriter es abstracta.The TextWriter class is an abstract class. Por lo tanto, no se crea una instancia de ella en el código.Therefore, you do not instantiate it in your code. La StreamWriter clase se deriva de TextWriter y proporciona implementaciones de los miembros para escribir en una secuencia.The StreamWriter class derives from TextWriter and provides implementations of the members for writing to a stream. En el ejemplo siguiente se muestra cómo escribir dos líneas que se componen de valores de cadena en un WriteLineAsync(String) archivo de texto mediante el método.The following example shows how to write two lines that consist of string values to a text file by using the WriteLineAsync(String) method.

Invalide Dispose en una clase derivada para proporcionarOverride Dispose in a derived class to provide

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

TextWriteres la clase base abstracta de StreamWriter y StringWriter, que escriben caracteres en secuencias y cadenas, respectivamente.TextWriter is the abstract base class of StreamWriter and StringWriter, which write characters to streams and strings, respectively. Cree una instancia de TextWriter para escribir un objeto en una cadena, escribir cadenas en un archivo o serializar XML.Create an instance of TextWriter to write an object to a string, write strings to a file, or to serialize XML. También puede usar una instancia de TextWriter para escribir texto en una memoria auxiliar personalizada con las mismas API que usaría para una cadena o un flujo, o para agregar compatibilidad con el formato de texto.You can also use an instance of TextWriter to write text to a custom backing store using the same APIs you would use for a string or a stream, or to add support for text formatting.

Todos los Write métodos de TextWriter tener tipos de datos primitivos como parámetros escriben los valores como cadenas.All the Write methods of TextWriter having primitive data types as parameters write out the values as strings.

De forma predeterminada, TextWriter un no es seguro para subprocesos.By default, a TextWriter is not thread safe. Vea TextWriter.Synchronized para obtener un contenedor seguro para subprocesos.See TextWriter.Synchronized for a thread-safe wrapper.

Importante

Este tipo implementa la interfaz IDisposable.This type implements the IDisposable interface. Cuando haya terminado de usar cualquier tipo que derive de este tipo, debe desecharlo directa o indirectamente.When you have finished using any type that derives from this type, you should dispose of it either directly or indirectly. Para eliminar el tipo directamente, llame a su método Dispose en un bloque try/catch.To dispose of the type directly, call its Dispose method in a try/catch block. Para deshacerse de él indirectamente, use una construcción de lenguaje como using (en C#) o Using (en Visual Basic).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Para obtener más información, vea Dispose y la sección "usar un objeto que implementa IDisposable" en IDisposable el tema de la interfaz.For more information, see Dispose and the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Notas a los desarrolladores de herederos

Una clase derivada debe implementar de forma mínima Write(Char) el método para crear una instancia útil TextWriterde.A derived class must minimally implement the Write(Char) method to make a useful instance of TextWriter.

Constructores

TextWriter() TextWriter() TextWriter() TextWriter()

Inicializa una nueva instancia de la clase TextWriter.Initializes a new instance of the TextWriter class.

TextWriter(IFormatProvider) TextWriter(IFormatProvider) TextWriter(IFormatProvider) TextWriter(IFormatProvider)

Inicializa una nueva instancia de la clase TextWriter con el control de formato especificado.Initializes a new instance of the TextWriter class with the specified format provider.

Campos

CoreNewLine CoreNewLine CoreNewLine CoreNewLine

Almacena los caracteres de nueva línea usados para el TextWriter.Stores the newline characters used for this TextWriter.

Null Null Null Null

Proporciona un TextWriter sin memoria auxiliar, en el que se puede escribir pero no se puede leer.Provides a TextWriter with no backing store that can be written to, but not read from.

Propiedades

Encoding Encoding Encoding Encoding

Cuando se reemplaza en una clase derivada, devuelve la codificación de caracteres en que se escribe el resultado.When overridden in a derived class, returns the character encoding in which the output is written.

FormatProvider FormatProvider FormatProvider FormatProvider

Obtiene un objeto que controla las operaciones de formato.Gets an object that controls formatting.

NewLine NewLine NewLine NewLine

Obtiene o establece la cadena de terminador de línea usada por el TextWriter actual.Gets or sets the line terminator string used by the current TextWriter.

Métodos

Close() Close() Close() Close()

Cierra el sistema de escritura actual y libera todos los recursos del sistema asociados al sistema de escritura.Closes the current writer and releases any system resources associated with the writer.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Libera todos los recursos utilizados por el objeto TextWriter.Releases all resources used by the TextWriter object.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera los recursos no administrados que usa TextWriter y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the TextWriter and optionally releases the managed resources.

DisposeAsync() DisposeAsync() DisposeAsync() DisposeAsync()

Libera de forma asincrónica todos los recursos que usa el objeto TextWriter.Asynchronously releases all resources used by the TextWriter object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Flush() Flush() Flush() 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.Clears all buffers for the current writer and causes any buffered data to be written to the underlying device.

FlushAsync() FlushAsync() FlushAsync() 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.Asynchronously clears all buffers for the current writer and causes any buffered data to be written to the underlying device.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Synchronized(TextWriter) Synchronized(TextWriter) Synchronized(TextWriter) Synchronized(TextWriter)

Crea un contenedor seguro para subprocesos en torno al TextWriter especificado.Creates a thread-safe wrapper around the specified TextWriter.

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)
Write(Boolean) Write(Boolean) Write(Boolean) Write(Boolean)

Escribe la representación de texto de un valor Boolean en la secuencia de texto.Writes the text representation of a Boolean value to the text stream.

Write(Char) Write(Char) Write(Char) Write(Char)

Escribe un carácter en la secuencia de texto.Writes a character to the text stream.

Write(Char[]) Write(Char[]) Write(Char[]) Write(Char[])

Escribe una matriz de caracteres en la secuencia de texto.Writes a character array to the text stream.

Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32)

Escribe una submatriz de caracteres en la secuencia de texto.Writes a subarray of characters to the text stream.

Write(Decimal) Write(Decimal) Write(Decimal) Write(Decimal)

Escribe la representación de texto de un valor decimal en la secuencia de texto.Writes the text representation of a decimal value to the text stream.

Write(Double) Write(Double) Write(Double) Write(Double)

Escribe la representación de texto de un punto flotante de 8 bytes en la secuencia de texto.Writes the text representation of an 8-byte floating-point value to the text stream.

Write(Int32) Write(Int32) Write(Int32) Write(Int32)

Escribe la representación de texto de un entero con signo de 4 bytes en la secuencia de texto.Writes the text representation of a 4-byte signed integer to the text stream.

Write(Int64) Write(Int64) Write(Int64) Write(Int64)

Escribe la representación de texto de un entero con signo de 8 bytes en la secuencia de texto.Writes the text representation of an 8-byte signed integer to the text stream.

Write(Object) Write(Object) Write(Object) 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.Writes the text representation of an object to the text stream by calling the ToString method on that object.

Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>)

Escribe un intervalo de caracteres en la secuencia de texto.Writes a character span to the text stream.

Write(Single) Write(Single) Write(Single) Write(Single)

Escribe la representación de texto de un valor de punto flotante de 4 bytes en la secuencia de texto.Writes the text representation of a 4-byte floating-point value to the text stream.

Write(String) Write(String) Write(String) Write(String)

Escribe una cadena en la secuencia de texto.Writes a string to the text stream.

Write(String, Object) Write(String, Object) Write(String, 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).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object) method.

Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, 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).Writes a formatted string to the text stream using the same semantics as the Format(String, Object, Object) method.

Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(String, Object, 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).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object, Object, Object) method.

Write(String, Object[]) Write(String, Object[]) Write(String, 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[]).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object[]) method.

Write(StringBuilder) Write(StringBuilder) Write(StringBuilder) Write(StringBuilder)

Escribe un generador de cadenas en la secuencia de texto.Writes a string builder to the text stream.

Write(UInt32) Write(UInt32) Write(UInt32) Write(UInt32)

Escribe la representación de texto de un entero sin signo de 4 bytes en la secuencia de texto.Writes the text representation of a 4-byte unsigned integer to the text stream.

Write(UInt64) Write(UInt64) Write(UInt64) Write(UInt64)

Escribe la representación de texto de un entero sin signo de 8 bytes en la secuencia de texto.Writes the text representation of an 8-byte unsigned integer to the text stream.

WriteAsync(Char) WriteAsync(Char) WriteAsync(Char) WriteAsync(Char)

Escribe un carácter en la secuencia de texto de forma asincrónica.Writes a character to the text stream asynchronously.

WriteAsync(Char[]) WriteAsync(Char[]) WriteAsync(Char[]) WriteAsync(Char[])

Escribe una matriz de caracteres en la secuencia de texto de forma asincrónica.Writes a character array to the text stream asynchronously.

WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32)

Escribe una submatriz de caracteres en la secuencia de texto de forma asincrónica.Writes a subarray of characters to the text stream asynchronously.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken) WriteAsync(ReadOnlyMemory<Char>, CancellationToken) WriteAsync(ReadOnlyMemory<Char>, CancellationToken) WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Escribe una región de la memoria de caracteres en la secuencia de texto de forma asincrónica.Asynchronously writes a character memory region to the text stream.

WriteAsync(String) WriteAsync(String) WriteAsync(String) WriteAsync(String)

Escribe una cadena en la secuencia de texto de forma asincrónica.Writes a string to the text stream asynchronously.

WriteAsync(StringBuilder, CancellationToken) WriteAsync(StringBuilder, CancellationToken) WriteAsync(StringBuilder, CancellationToken) WriteAsync(StringBuilder, CancellationToken)

Escribe un generador de cadenas en la secuencia de texto de forma asincrónica.Asynchronously writes a string builder to the text stream.

WriteLine() WriteLine() WriteLine() WriteLine()

Escribe un terminador de línea en la secuencia de texto.Writes a line terminator to the text stream.

WriteLine(Boolean) WriteLine(Boolean) WriteLine(Boolean) WriteLine(Boolean)

Escribe la representación de texto de un valor Boolean seguida de un terminador de línea en la secuencia de texto.Writes the text representation of a Boolean value to the text stream, followed by a line terminator.

WriteLine(Char) WriteLine(Char) WriteLine(Char) WriteLine(Char)

Escribe un carácter seguido de un terminador de línea en la secuencia de texto.Writes a character to the text stream, followed by a line terminator.

WriteLine(Char[]) WriteLine(Char[]) WriteLine(Char[]) WriteLine(Char[])

Escribe una matriz de caracteres seguida de un terminador de línea en la secuencia de texto.Writes an array of characters to the text stream, followed by a line terminator.

WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32)

Escribe una submatriz de caracteres seguida de un terminador de línea en la secuencia de texto.Writes a subarray of characters to the text stream, followed by a line terminator.

WriteLine(Decimal) WriteLine(Decimal) WriteLine(Decimal) WriteLine(Decimal)

Escribe la representación de texto de un valor decimal seguida de un terminador de línea en la secuencia de texto.Writes the text representation of a decimal value to the text stream, followed by a line terminator.

WriteLine(Double) WriteLine(Double) WriteLine(Double) 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.Writes the text representation of a 8-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(Int32) WriteLine(Int32) WriteLine(Int32) 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.Writes the text representation of a 4-byte signed integer to the text stream, followed by a line terminator.

WriteLine(Int64) WriteLine(Int64) WriteLine(Int64) 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.Writes the text representation of an 8-byte signed integer to the text stream, followed by a line terminator.

WriteLine(Object) WriteLine(Object) WriteLine(Object) 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.Writes the text representation of an object to the text stream, by calling the ToString method on that object, followed by a line terminator.

WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>) 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.Writes the text representation of a character span to the text stream, followed by a line terminator.

WriteLine(Single) WriteLine(Single) WriteLine(Single) 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.Writes the text representation of a 4-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(String) WriteLine(String) WriteLine(String) WriteLine(String)

Escribe una cadena seguida de un terminador de línea en la secuencia de texto.Writes a string to the text stream, followed by a line terminator.

WriteLine(String, Object) WriteLine(String, Object) WriteLine(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 el método Format(String, Object).Writes a formatted string and a new line to the text stream, using the same semantics as the Format(String, Object) method.

WriteLine(String, Object, Object) WriteLine(String, Object, Object) WriteLine(String, Object, 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).Writes a formatted string and a new line to the text stream, using the same semantics as the Format(String, Object, Object) method.

WriteLine(String, Object, Object, Object) WriteLine(String, Object, Object, Object) WriteLine(String, Object, 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).Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

WriteLine(String, Object[]) WriteLine(String, Object[]) WriteLine(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).Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

WriteLine(StringBuilder) WriteLine(StringBuilder) WriteLine(StringBuilder) 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.Writes the text representation of a string builder to the text stream, followed by a line terminator.

WriteLine(UInt32) WriteLine(UInt32) WriteLine(UInt32) 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.Writes the text representation of a 4-byte unsigned integer to the text stream, followed by a line terminator.

WriteLine(UInt64) WriteLine(UInt64) WriteLine(UInt64) 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.Writes the text representation of an 8-byte unsigned integer to the text stream, followed by a line terminator.

WriteLineAsync() WriteLineAsync() WriteLineAsync() WriteLineAsync()

Escribe un terminador de línea en la secuencia de texto de forma asincrónica.Asynchronously writes a line terminator to the text stream.

WriteLineAsync(Char) WriteLineAsync(Char) WriteLineAsync(Char) WriteLineAsync(Char)

Escribe un carácter seguido de un terminador de línea en la secuencia de texto de forma asincrónica.Asynchronously writes a character to the text stream, followed by a line terminator.

WriteLineAsync(Char[]) WriteLineAsync(Char[]) WriteLineAsync(Char[]) WriteLineAsync(Char[])

Escribe una matriz de caracteres seguida de un terminador de línea en la secuencia de texto de forma asincrónica.Asynchronously writes an array of characters to the text stream, followed by a line terminator.

WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32) 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.Asynchronously writes a subarray of characters to the text stream, followed by a line terminator.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) 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.Asynchronously writes the text representation of a character memory region to the text stream, followed by a line terminator.

WriteLineAsync(String) WriteLineAsync(String) WriteLineAsync(String) WriteLineAsync(String)

Escribe una cadena seguida de un terminador de línea en la secuencia de texto de forma asincrónica.Asynchronously writes a string to the text stream, followed by a line terminator.

WriteLineAsync(StringBuilder, CancellationToken) WriteLineAsync(StringBuilder, CancellationToken) WriteLineAsync(StringBuilder, CancellationToken) 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.Asynchronously writes the text representation of a string builder to the text stream, followed by a line terminator.

Implementaciones de interfaz explícitas

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

Para una descripción de este miembro, vea Dispose().For a description of this member, see Dispose().

Se aplica a

Consulte también: