StreamWriter (Clase)

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

.NET Framework Client Profile

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

Referencia

Otros recursos