Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

StreamWriter (Clase)

Implementa TextWriter para escribir los caracteres de una secuencia en una codificación determinada.

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

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class StreamWriter : TextWriter

El tipo StreamWriter expone los siguientes miembros.

  NombreDescripción
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifStreamWriter(Stream)Inicializa una nueva instancia de la clase StreamWriter para la secuencia especificada, con la codificación UTF-8 y el tamaño de búfer predeterminado.
Método públicoCompatible con XNA FrameworkStreamWriter(String)Inicializa una nueva instancia de la clase StreamWriter para el archivo especificado en la ruta de acceso especificada y con la codificación y el tamaño de búfer predeterminados.
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifStreamWriter(Stream, Encoding)Inicializa una nueva instancia de la clase StreamWriter para la secuencia especificada, con la codificación especificada y el tamaño de búfer predeterminado.
Método públicoCompatible con XNA FrameworkStreamWriter(String, Boolean)Inicializa una nueva instancia de la clase StreamWriter para el archivo especificado en la ruta de acceso especificada y con la codificación y el tamaño de búfer predeterminados. Si el archivo ya existe, es posible sobrescribir o anexar datos al mismo. Si el archivo no existe, este constructor crea uno nuevo.
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifStreamWriter(Stream, Encoding, Int32)Inicializa una nueva instancia de la clase StreamWriter para la secuencia especificada, con la codificación y el tamaño de búfer especificados.
Método públicoCompatible con XNA FrameworkStreamWriter(String, Boolean, Encoding)Inicializa una nueva instancia de la clase StreamWriter para el archivo especificado en la ruta de acceso especificada, con la codificación especificada y el tamaño de búfer predeterminado. Si el archivo ya existe, es posible sobrescribir o anexar datos al mismo. Si el archivo no existe, este constructor crea uno nuevo.
Método públicoCompatible con XNA FrameworkStreamWriter(String, Boolean, Encoding, Int32)Inicializa una nueva instancia de la clase StreamWriter para el archivo especificado en la ruta de acceso especificada, con la codificación y el tamaño de búfer especificados. Si el archivo ya existe, es posible sobrescribir o anexar datos al mismo. Si el archivo no existe, este constructor crea uno nuevo.
Arriba

  NombreDescripción
Propiedad públicaCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifAutoFlushObtiene o establece un valor que indica si StreamWriter vaciará su búfer en la secuencia subyacente después de cada llamada a StreamWriter.Write.
Propiedad públicaCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifBaseStreamObtiene la secuencia subyacente que interactúa con un almacén de respaldo.
Propiedad públicaCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifEncodingObtiene el Encoding donde se escribe el resultado. (Invalida a TextWriter.Encoding).
Propiedad públicaCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifFormatProviderObtiene un objeto que controla las operaciones de formato. (Se hereda de TextWriter).
Propiedad públicaCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifNewLineObtiene o establece la cadena de terminador de línea utilizada por el TextWriter actual. (Se hereda de TextWriter).
Arriba

  NombreDescripción
Método públicoCompatible con XNA FrameworkCloseCierra el actual objeto StreamWriter y la secuencia subyacente. (Invalida a TextWriter.Close()).
Método públicoCreateObjRefCrea 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).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifDispose()Libera todos los recursos utilizados por el objeto TextWriter. (Se hereda de TextWriter).
Método protegidoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifDispose(Boolean)Libera los recursos no administrados que utiliza StreamWriter y libera los recursos administrados de forma opcional. (Invalida a TextWriter.Dispose(Boolean)).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifEquals(Object)Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método protegidoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Se hereda de Object).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifFlushBorra todos los búferes del sistema de escritura actual y hace que todos los datos almacenados en el búfer se escriban en la secuencia subyacente. (Invalida a TextWriter.Flush()).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifGetHashCodeActúa como función hash para un tipo concreto. (Se hereda de Object).
Método públicoGetLifetimeServiceRecupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoInitializeLifetimeServiceObtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegidoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifMemberwiseClone() Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoMemberwiseClone(Boolean)Crea una copia superficial del objeto MarshalByRefObject actual. (Se hereda de MarshalByRefObject).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWrite(Boolean)Escribe la representación de texto de un valor de tipo Boolean en la secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWrite(Char)Escribe un carácter en la secuencia. (Invalida a TextWriter.Write(Char)).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWrite(Char[])Escribe una matriz de caracteres en la secuencia. (Invalida a TextWriter.Write(Char[])).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWrite(Decimal)Escribe la representación de texto de un valor decimal en la secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWrite(Double)Escribe la representación de texto de un valor de punto flotante de 8 bytes en la secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWrite(Int32)Escribe la representación de texto de un entero con signo de 4 bytes en la secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWrite(Int64)Escribe la representación de texto de un entero con signo de 8 bytes en la secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWrite(Object)Escribe la representación de texto de un objeto en la secuencia de texto mediante una llamada a ToString en ese objeto. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWrite(Single)Escribe la representación de texto de un valor de punto flotante de 4 bytes en la secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWrite(String)Escribe una cadena en la secuencia. (Invalida a TextWriter.Write(String)).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWrite(UInt32)Escribe la representación de texto de un entero sin signo de 4 bytes en la secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWrite(UInt64)Escribe la representación de texto de un entero sin signo de 8 bytes en la secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkWrite(String, Object)Escribe una cadena con formato utilizando la misma semántica que String.Format. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWrite(String, Object[])Escribe una cadena con formato utilizando la misma semántica que String.Format. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWrite(Char[], Int32, Int32)Escribe una submatriz de caracteres en la secuencia. (Invalida a TextWriter.Write(Char[], Int32, Int32)).
Método públicoCompatible con XNA FrameworkWrite(String, Object, Object)Escribe una cadena con formato utilizando la misma semántica que String.Format. (Se hereda de TextWriter).
Método públicoWrite(String, Object, Object, Object)Escribe una cadena con formato utilizando la misma semántica que String.Format. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWriteLine()Escribe un terminador de línea en la secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWriteLine(Boolean)Escribe la representación de texto de un valor de tipo Boolean seguida de un terminador de línea en la secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWriteLine(Char)Escribe un carácter seguido de un terminador de línea en la secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWriteLine(Char[])Escribe una matriz de caracteres seguida de un terminador de línea en la secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWriteLine(Decimal)Escribe la representación de texto de un valor decimal seguida de un terminador de línea en la secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWriteLine(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. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWriteLine(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. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWriteLine(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. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWriteLine(Object)Escribe la representación de texto de un objeto mediante una llamada a ToString en este objeto, seguida de un terminador de línea en la secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWriteLine(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. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWriteLine(String)Escribe una cadena seguida de un terminador de línea en la secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWriteLine(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. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWriteLine(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. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkWriteLine(String, Object)Escribe una cadena con formato y una nueva línea utilizando la misma semántica que Format. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWriteLine(String, Object[])Escribe una cadena con formato y una nueva línea utilizando la misma semántica que Format. (Se hereda de TextWriter).
Método públicoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifWriteLine(Char[], Int32, Int32)Escribe una submatriz de caracteres seguida de un terminador de línea en la secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkWriteLine(String, Object, Object)Escribe una cadena con formato y una nueva línea utilizando la misma semántica que Format. (Se hereda de TextWriter).
Método públicoWriteLine(String, Object, Object, Object)Escribe una cadena con formato y una nueva línea utilizando la misma semántica que Format. (Se hereda de TextWriter).
Arriba

  NombreDescripción
Campo protegidoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifCoreNewLineAlmacena los caracteres de nueva línea utilizados para el TextWriter. (Se hereda de TextWriter).
Campo públicoMiembro estáticoCompatible con XNA Framework3ssew6tk.PortableClassLibrary(es-es,VS.100).gifNullProporciona un StreamWriter sin almacén de respaldo en el que se puede escribir, pero que no puede leerse.
Arriba

StreamWriter está diseñado para obtener caracteres como salida en una codificación determinada, mientras que las clases derivadas de Stream están diseñadas para entrada y salida de bytes.

StreamWriter utiliza de forma predeterminada una instancia de UTF8Encoding, a menos que se especifique lo contrario. Esta instancia de UTF8Encoding se construye sin marca de orden de bytes (BOM), por lo que su método GetPreamble devuelve una matriz de bytes vacía. Para crear StreamWriter mediante la codificación UTF-8 y una marca BOM, considere la posibilidad de utilizar un constructor que especifique la codificación, como StreamWriter(String, Boolean, Encoding).

De forma predeterminada, StreamWriter no es seguro para el uso 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.

En el siguiente ejemplo se muestra cómo utilizar un objeto StreamWriter para escribir un archivo que enumera los directorios en la unidad C y, a continuación, utilizar un objeto StreamReader para leer y mostrar cada nombre de directorio. Conviene utilizar estos objetos en una instrucción using para que se dispongan correctamente los recursos no administrados. La instrucción using llama automáticamente a Dispose en el objeto cuando el código que está utilizándolo ha completado.


using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.IO;

namespace StreamReadWrite
{
    class Program
    {
        static void Main(string[] args)
        {
            // Get the directories currently on the C drive.
            DirectoryInfo[] cDirs = new DirectoryInfo(@"c:\").GetDirectories();

            // Write each directory name to a file.
            using (StreamWriter sw = new StreamWriter("CDriveDirs.txt"))
            {
                foreach (DirectoryInfo dir in cDirs)
                {
                    sw.WriteLine(dir.Name);

                }
            }

            // Read and show each line from the file.
            string line = "";
            using (StreamReader sr = new StreamReader("CDriveDirs.txt"))
            {
                while ((line = sr.ReadLine()) != null)
                {
                    Console.WriteLine(line);
                }
            }
        }
    }
}


.NET Framework

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

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Compatible con:

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.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.

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.
Mostrar: