StreamReader, classe

StreamReader est conçu pour l'entrée de caractères dans un encodage particulier, tandis que la classe Stream est conçue pour l'entrée et la sortie d'octets. Utilisez StreamReader pour lire des lignes d'informations à partir d'un fichier texte standard.

Sauf spécification contraire, l'encodage par défaut de StreamReader est UTF-8, plutôt que la page de codes ANSI par défaut du système actuel. UTF-8 gère correctement les caractères Unicode et fournit des résultats cohérents sur les versions localisées du système d'exploitation.

Par défaut, StreamReader n'est pas thread-safe. Consultez TextReader.Synchronized pour plus d'informations sur un wrapper thread-safe.

Les surcharges des méthodes Read(Char[], Int32, Int32) et Write(Char[], Int32, Int32) lisent et écrivent le nombre de caractères spécifiés par le paramètre count. Ils doivent être distingués de BufferedStream.Read et BufferedStream.Write, qui lisent et écrivent le nombre d'octets spécifié par le paramètre count. Utilisez les méthodes BufferedStream uniquement pour la lecture et l'écriture d'un nombre entier d'éléments du tableau d'octets.

Remarque
Lors de la lecture de Stream, il est plus efficace d'utiliser une mémoire tampon de la même taille que la mémoire tampon interne du flux.

Pour obtenir la liste des tâches d'E/S courantes, consultez Tâches d'E/S courantes.

L'exemple suivant utilise une instance de StreamReader pour lire le texte d'un fichier.

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 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Référence

Autres ressources