TextReader.ReadToEnd Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Source:

TextReader.cs

Lit tous les caractères entre la position actuelle et la fin du lecteur de texte, puis les retourne sous forme d'une chaîne.

public:
 virtual System::String ^ ReadToEnd();

public virtual string ReadToEnd ();

abstract member ReadToEnd : unit -> string
override this.ReadToEnd : unit -> string

Public Overridable Function ReadToEnd () As String

Retours

String

Chaîne contenant tous les caractères entre la position actuelle et la fin du lecteur de texte.

Exceptions

IOException

Une erreur d’E/S se produit.

ObjectDisposedException

Le TextReader est fermé.

OutOfMemoryException

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

ArgumentOutOfRangeException

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

Remarques

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 déjà lus dans la mémoire tampon interne ReadToEnd sont ignorés. Étant donné que la position du lecteur dans le flux ne peut pas être modifiée, les caractères qui ont déjà été lus sont irrécupérables et sont accessibles uniquement en réinitialisant le 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 ReadToEnd méthode , consultez la StreamReader.ReadToEnd méthode .

Voir aussi

• ReadToEnd()
• ReadToEnd()
• Fichier et flux de données E/S
• Procédure : lire le texte d’un fichier
• Procédure : écrire du texte dans un fichier