Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.

Traducción

Original

Personas que lo han encontrado útil: 1 de 1 - Valorar este tema

TextWriter (Clase)

.NET Framework 4.5

Otras versiones

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

Jerarquía de herencia

System.Object
  System.MarshalByRefObject
    System.IO.TextWriter
      System.CodeDom.Compiler.IndentedTextWriter
      System.IO.StreamWriter
      System.IO.StringWriter
      System.Web.HttpWriter
      System.Web.UI.HtmlTextWriter

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

Sintaxis

C++

[<AbstractClass>]
[<SerializableAttribute>]
[<ComVisibleAttribute(true)>]
type TextWriter =  
    class
        inherit MarshalByRefObject
        interface IDisposable
    end

El tipo TextWriter expone los siguientes miembros.

Constructores

	Nombre	Descripción
	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.

Arriba

Propiedades

	Nombre	Descripción
	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 utilizada por el TextWriter actual.

Arriba

Métodos

	Nombre	Descripción
	Close	Cierra el sistema de escritura actual y libera todos los recursos del sistema asociados al sistema de escritura.
	CreateObjRef	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject).
	Dispose()	Libera todos los recursos utilizados por el objeto TextWriter.
	Dispose(Boolean)	Libera los recursos no administrados que utiliza TextWriter y libera los recursos administrados de forma opcional.
	Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
	Finalize	Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda 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.
	GetHashCode	Actúa como función hash para un tipo concreto. (Se hereda de Object).
	GetLifetimeService	Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
	GetType	Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
	InitializeLifetimeService	Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
	MemberwiseClone()	Crea una copia superficial del Object actual. (Se hereda de Object).
	MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Se hereda de MarshalByRefObject).
	Synchronized	Crea un contenedor seguro para subprocesos en torno al TextWriter especificado.
	ToString	Devuelve una cadena que representa el objeto actual. (Se hereda de Object).
	Write(Boolean)	Escribe la representación de texto de un valor Boolean en la cadena o secuencia de texto.
	Write(Char)	Escribe un carácter en la cadena o secuencia de texto.
	Write(Char[])	Escribe una matriz de caracteres en la cadena o secuencia de texto.
	Write(Decimal)	Escribe la representación de texto de un valor decimal en la cadena o secuencia de texto.
	Write(Double)	Escribe la representación de texto de un valor de punto flotante de 8 bytes en la cadena o secuencia de texto.
	Write(Int32)	Escribe la representación de texto de un entero con signo de 4 bytes en la cadena o secuencia de texto.
	Write(Int64)	Escribe la representación de texto de un entero con signo de 8 bytes en la cadena o secuencia de texto.
	Write(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.
	Write(Single)	Escribe la representación de texto de un valor de punto flotante de 4 bytes en la cadena o secuencia de texto.
	Write(String)	Escribe una cadena en la cadena o secuencia de texto.
	Write(UInt32)	Escribe la representación de texto de un entero sin signo de 4 bytes en la cadena o secuencia de texto.
	Write(UInt64)	Escribe la representación de texto de un entero sin signo de 8 bytes en la cadena o secuencia de texto.
	Write(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) .
	Write(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[]) .
	Write(Char[], Int32, Int32)	Escribe una submatriz de caracteres en la cadena o secuencia de texto.
	Write(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) .
	Write(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) .
	WriteAsync(Char)	Escribe un carácter en la cadena o secuencia de texto de forma asincrónica.
	WriteAsync(Char[])	Escribe una matriz de caracteres en la cadena o secuencia de texto de forma asincrónica.
	WriteAsync(String)	Escribe una cadena en la cadena o secuencia de texto de forma asincrónica.
	WriteAsync(Char[], Int32, Int32)	Escribe una submatriz de caracteres en la cadena o secuencia de texto de forma asincrónica.
	WriteLine()	Escribe un terminador de línea en la cadena o secuencia.
	WriteLine(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.
	WriteLine(Char)	Escribe un carácter seguido de un terminador en la cadena o la secuencia de texto.
	WriteLine(Char[])	Escribe una matriz de caracteres seguida de un terminador de línea en la cadena o secuencia de texto.
	WriteLine(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.
	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 cadena o 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 cadena o 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 cadena o 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 cadena o 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 cadena o secuencia de texto.
	WriteLine(String)	Escribe una cadena seguida de un terminador en la cadena o 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 cadena o 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 cadena o secuencia de texto.
	WriteLine(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) .
	WriteLine(String, Object[])	Escribe una cadena con formato y una nueva línea utilizando la misma semántica que Format.
	WriteLine(Char[], Int32, Int32)	Escribe una submatriz de caracteres seguida de un terminador de línea en la cadena o secuencia de texto.
	WriteLine(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) .
	WriteLine(String, Object, Object, Object)	Escribe una cadena con formato y una nueva línea utilizando la misma semántica que Format.
	WriteLineAsync()	Escribe un terminador de línea en la cadena o secuencia de forma asincrónica.
	WriteLineAsync(Char)	Escribe un carácter seguido de un terminador de forma asincrónica en la cadena o la secuencia de texto.
	WriteLineAsync(Char[])	Escribe una matriz de caracteres seguida de un terminador de línea de forma asincrónica en la cadena o secuencia de texto.
	WriteLineAsync(String)	Escribe una cadena seguido de un terminador de forma asincrónica en la cadena o la secuencia de texto.
	WriteLineAsync(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.

Arriba

Campos

	Nombre	Descripción
	CoreNewLine	Almacena los caracteres de nueva línea usados para el TextWriter.
	Null	Proporciona un objeto TextWriter sin memoria auxiliar, en el que se puede escribir pero no se puede leer.

Arriba

Comentarios

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 una memoria auxiliar personalizada utilizando las mismas API que utilizaría para una cadena o una secuencia, o para proporcionar compatibilidad con el formato de texto.

Todos los métodos Write de TextWriter que tienen tipos de datos primitivos como parámetros escriben los valores en forma de cadena.

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

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

Notas para los herederos

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

Ejemplos

La clase TextWriter es una clase abstracta. Por consiguiente, se crean instancias en el código. La clase StreamWriter deriva TextWriter y proporciona implementaciones de miembros para escribir en una secuencia. El ejemplo siguiente se muestra cómo escribir dos líneas compuestos de valores de cadena en un archivo de texto utilizando el método WriteLineAsync(String) .

No hay ningún ejemplo de código disponible o este idioma no es compatible.

Información de versión

.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Biblioteca de clases portable

Compatible con: Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Vea también

Referencia

System.IO (Espacio de nombres)

StreamWriter

StringWriter

Otros recursos

E/S de archivos y secuencias

Cómo: Leer texto de un archivo

Cómo: Escribir texto en un archivo

Cómo: Leer y escribir en un archivo de datos recién creado

¿Te ha resultado útil? Sí No

No es preciso

No es lo suficientemente profundo

Se necesitan ejemplos de código adicionales

La traducción necesita mejoras

(Caracteres restantes: 1500)

Adiciones de comunidad

AGREGAR