TextReader.ReadLine Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> stringPublic Overridable Function ReadLine () As StringRetours
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 pour la chaîne retournée.
La TextReader fermeture est terminé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 saut de ligne (0x000a), d’un retour chariot suivi d’un flux de ligne, Environment.NewLineou de la fin de l’entrée du lecteur. 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 de l’entrée a été atteinte.
Si l’entrée se termine par une séquence de sauts de ligne, aucune ligne vide supplémentaire n’est retournée. Par exemple, l’entrée contenant "line1\nline2\n" produit les mêmes deux lignes ("line1" et "line2") que l’entrée contenant "line1\nline2".
Si la méthode lève une OutOfMemoryException exception, la position du lecteur dans sa source sous-jacente est avancée par le nombre de caractères que la méthode a pu lire, mais les caractères déjà lus dans la mémoire tampon interne ReadLine sont ignorés. Étant donné que la position du lecteur dans la source sous-jacente ne peut pas être réinitialisé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 la source sous-jacente est inconnue ou si la source ne prend pas en charge le repositionnement, la source sous-jacente doit également être réinitialisée.
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 TextReader classe 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.
