TextWriter Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa un escritor 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 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 |
Null |
Proporciona un |
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 |
Métodos
Close() |
Cierra el escritor actual y libera los recursos del sistema asociados al escritor. |
CreateBroadcasting(TextWriter[]) |
Crea una instancia de TextWriter que escribe entradas proporcionadas en cada uno de los escritores de |
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 |
ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
Write(Boolean) |
Escribe la representación de texto de un valor de |
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 |
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(String, ReadOnlySpan<Object>) |
Escribe una cadena con formato en la secuencia de texto, con la misma semántica que Format(String, ReadOnlySpan<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 |
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 |
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(String, ReadOnlySpan<Object>) |
Escribe una cadena con formato y una nueva línea en la secuencia de texto, con la misma semántica que Format(String, ReadOnlySpan<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. |
Implementaciones de interfaz explícitas
IDisposable.Dispose() |
Para obtener una descripción de este miembro, consulte Dispose(). |
Métodos de extensión
ConfigureAwait(IAsyncDisposable, Boolean) |
Configura cómo se realizan las esperas en las tareas devueltas desde un descartable asincrónico. |
Se aplica a
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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de