Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

StreamReader.ReadLine méthode ()

 

Date de publication : novembre 2016

Lit une ligne de caractères du flux actuel et retourne les données sous forme de chaîne.

Espace de noms:   System.IO
Assembly:  mscorlib (dans mscorlib.dll)

public override string ReadLine()

Valeur de retour

Type: System.String

Ligne suivante du flux d'entrée, ou null si la fin du flux d'entrée est atteinte.

Exception Condition
OutOfMemoryException

La mémoire est insuffisante pour allouer une mémoire tampon pour la chaîne retournée.

IOException

Une erreur d’E/S se produit.

Une ligne est définie comme une séquence de caractères suivi d’une ligne d’alimentation (« \n »), un retour chariot (« \r ») ou un retour chariot immédiatement suivi d’une ligne d’alimentation (« \r\n »). La chaîne retournée ne contient pas le retour chariot ou saut de ligne. La valeur retournée est null Si la fin du flux d’entrée est atteinte.

Cette méthode substitue TextReader.ReadLine.

Si la méthode actuelle lève une OutOfMemoryException, la position du lecteur dans sous-jacent Stream objet est avancé par le nombre de caractères que la méthode a pu lire, mais les caractères déjà lus dans la liste interne ReadLine tampon sont ignorés. Si vous manipulez la position du flux sous-jacent après la lecture des données dans la mémoire tampon, la position du flux sous-jacent ne peut pas correspondre la position de la mémoire tampon interne. Pour rétablir la mémoire tampon interne, appelez la DiscardBufferedData méthode ; Toutefois, cette méthode ralentit les performances et doit être appelée uniquement lorsque cela est absolument nécessaire.

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

L’exemple de code suivant lit les lignes à partir d’un fichier jusqu'à la fin du fichier.

using System;
using System.IO;

class Test 
{

    public static void Main() 
    {
        string path = @"c:\temp\MyTest.txt";
        try 
        {
            if (File.Exists(path)) 
            {
                File.Delete(path);
            }

            using (StreamWriter sw = new StreamWriter(path)) 
            {
                sw.WriteLine("This");
                sw.WriteLine("is some text");
                sw.WriteLine("to test");
                sw.WriteLine("Reading");
            }

            using (StreamReader sr = new StreamReader(path)) 
            {
                while (sr.Peek() >= 0) 
                {
                    Console.WriteLine(sr.ReadLine());
                }
            }
        } 
        catch (Exception e) 
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: