StreamReader (Clase)

StreamReader está diseñado para la entrada de caracteres mediante una codificación determinada, mientras que la clase Stream está diseñada para la entrada y salida de bytes. Se utiliza StreamReader para leer líneas de información desde un archivo de texto estándar.

StreamReader adopta la codificación UTF-8 de forma predeterminada, a menos que se especifique otra, en lugar de utilizar la página de códigos ANSI del sistema actual. UTF-8 utiliza los caracteres Unicode correctamente y ofrece resultados coherentes en versiones traducidas del sistema operativo.

De forma predeterminada, StreamReader no es seguro para la ejecución de subprocesos. Para obtener información sobre los contenedores seguros para subprocesos, vea TextReader.Synchronized.

Las sobrecargas de los métodos Read(Char[], Int32, Int32) y Write(Char[], Int32, Int32) leen y escriben el número de caracteres especificado por el parámetro count. Éstos deben diferenciarse de BufferedStream.Read y BufferedStream.Write, que leen y escriben el número de bytes especificado en el parámetro count. Utilice los métodos BufferedStream sólo para leer y escribir un número integral de elementos de matriz de bytes.

Nota
Cuando se lee de un Stream, es más eficaz utilizar un búfer que sea del mismo tamaño que el búfer interno de la secuencia.

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

En el siguiente ejemplo se utiliza una instancia de StreamReader para leer el texto de un archivo.

using System;
using System.IO;

class Test 
{
    public static void Main() 
    {
        try 
        {
            // Create an instance of StreamReader to read from a file.
            // The using statement also closes the StreamReader.
            using (StreamReader sr = new StreamReader("TestFile.txt")) 
            {
                string line;
                // Read and display lines from the file until the end of 
                // the file is reached.
                while ((line = sr.ReadLine()) != null) 
                {
                    Console.WriteLine(line);
                }
            }
        }
        catch (Exception e) 
        {
            // Let the user know what went wrong.
            Console.WriteLine("The file could not be read:");
            Console.WriteLine(e.Message);
        }
    }
}

.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