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

StreamReader (Clase)

.NET Framework 2.0

Otras versiones

Implementa un TextReader que lee los caracteres de una secuencia de bytes en una codificación determinada.

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

Sintaxis

C++

Copiar

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public class StreamReader : TextReader

Copiar

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public class StreamReader extends TextReader

JScript

Copiar

SerializableAttribute 
ComVisibleAttribute(true) 
public class StreamReader extends TextReader

Comentarios

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 un ejemplo de cómo utilizar esta clase, vea la sección Ejemplo. En la siguiente tabla se muestran ejemplos de otras tareas de E/S típicas o relacionadas.

Para realizar esta operación...	Vea el ejemplo de este tema...
Crear un archivo de texto	Cómo: Escribir texto en un archivo
Escribir en un archivo de texto.	Cómo: Escribir texto en un archivo
Leer de un archivo de texto.	Cómo: Leer texto de un archivo
Anexar texto a un archivo.	Cómo: Abrir y anexar a un archivo de registro File.AppendText FileInfo.AppendText
Obtener el tamaño de un archivo.	FileInfo.Length
Obtener los atributos de un archivo.	File.GetAttributes
Establecer los atributos de un archivo.	File.SetAttributes
Determinar si existe un archivo.	File.Exists
Leer de un archivo binario.	Cómo: Leer y escribir en un archivo de datos recién creado
Escribir en un archivo binario.	Cómo: Leer y escribir en un archivo de datos recién creado

Ejemplo

En el siguiente ejemplo de código se utiliza un objeto StreamReader para leer el texto de un archivo.

C++

Copiar

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);
        }
    }
}

Copiar

import System.*;
import System.IO.*;

class Test
{
    public static void main(String[] args)
    {
        try {            
            // Create an instance of StreamReader to read from a file.
            // The using statement also closes the StreamReader.
            StreamReader sr = new StreamReader("TestFile.txt");
            try {
                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);
                }
            }
            finally {
                sr.Dispose();
            }            
        }
        catch (System.Exception e) {
            // Let the user know what went wrong.
            Console.WriteLine("The file could not be read:");
            Console.WriteLine(e.get_Message());
        }
    } //main
} //Test

Jerarquía de herencia

System.Object
   System.MarshalByRefObject
     System.IO.TextReader
      System.IO.StreamReader

Seguridad para subprocesos

Los miembros estáticos públicos (Shared en Visual Basic) 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.

Plataformas

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

Información de versión