Partager via


TextReader.ReadLine Méthode

Définition

Lit une ligne de caractères à partir du lecteur de texte et retourne les données sous forme de chaîne.

public:
 virtual System::String ^ ReadLine();
public virtual string ReadLine ();
public virtual string? ReadLine ();
abstract member ReadLine : unit -> string
override this.ReadLine : unit -> string
Public Overridable Function ReadLine () As String

Retours

La ligne suivante du lecteur ou null si tous les caractères ont été lus.

Exceptions

Une erreur d’E/S se produit.

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

Le nombre de caractères dans la ligne suivante est supérieur à Int32.MaxValue

Remarques

Une ligne est définie comme une séquence de caractères suivie d’un retour chariot (0x000d), d’un flux de ligne (0x000a), d’un retour chariot suivi d’un flux de ligne, Environment.NewLineou du marqueur de fin de flux. La chaîne retournée ne contient pas le retour chariot de fin ou le flux de ligne. La valeur de retour est null si la fin du flux d’entrée a été atteinte.

Si la méthode lève une OutOfMemoryException exception, la position du lecteur dans le sous-jacent Stream est avancée par le nombre de caractères que la méthode a pu lire, mais les caractères qui ont déjà été lus dans la mémoire tampon interne ReadLine sont ignorés. Étant donné que la position du lecteur dans le flux ne peut pas être modifiée, les caractères déjà lus sont irrécupérables et sont accessibles uniquement en réinitialisant l’objet TextReader . Si la position initiale dans le flux est inconnue ou si le flux ne prend pas en charge la recherche, le sous-jacent Stream doit également être réinitialisé.

Pour éviter une telle situation et produire du code robuste, vous devez utiliser la Read méthode et stocker les caractères de lecture dans une mémoire tampon préallouée.

La classe TextReader est une classe abstraite. Par conséquent, vous ne l’instanciez pas dans votre code. Pour obtenir un exemple d’utilisation de la ReadLine méthode, consultez la StreamReader.ReadLine méthode .

S’applique à

Voir aussi