TextReader.Read Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Lit les données dans le lecteur de texte.

Surcharges

Read()	Lit le caractère suivant à partir du lecteur de texte et avance la position d'un caractère.
Read(Span<Char>)	Lit les caractères à partir du lecteur actuel et écrit les données dans la mémoire tampon spécifiée.
Read(Char[], Int32, Int32)	Lit un nombre maximal spécifié de caractères à partir du lecteur actuel et écrit les données dans une mémoire tampon, en commençant à l'index spécifié.

Read()

Source:

TextReader.cs

Lit le caractère suivant à partir du lecteur de texte et avance la position d'un caractère.

public:
 virtual int Read();

public virtual int Read ();

abstract member Read : unit -> int
override this.Read : unit -> int

Public Overridable Function Read () As Integer

Retours

Int32

Caractère suivant du lecteur de texte ou -1 s'il n'y a plus de caractères disponibles. L'implémentation par défaut retourne -1.

Exceptions

ObjectDisposedException

Le TextReader est fermé.

IOException

Une erreur d’E/S se produit.

Remarques

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 Read méthode, consultez la StreamReader.Read méthode .

Voir aussi

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

Read(Span<Char>)

Source:

TextReader.cs

Lit les caractères à partir du lecteur actuel et écrit les données dans la mémoire tampon spécifiée.

public:
 virtual int Read(Span<char> buffer);

public virtual int Read (Span<char> buffer);

abstract member Read : Span<char> -> int
override this.Read : Span<char> -> int

Public Overridable Function Read (buffer As Span(Of Char)) As Integer

Paramètres

buffer

Span<Char>

Quand cette méthode retourne un résultat, contient l’étendue spécifiée de caractères remplacés par les caractères lus dans la source actuelle.

Retours

Int32

Nombre de caractères lus. Le nombre sera inférieur ou égal à la longueur buffer, selon les données disponibles dans le lecteur. Cette méthode retourne zéro si elle est appelée alors qu'il ne reste aucun caractère à lire.

Exceptions

ArgumentNullException

buffer a la valeur null.

IOException

Le nombre de caractères lus à partir du flux est supérieur à la longueur de la buffer.

Read(Char[], Int32, Int32)

Source:

TextReader.cs

Lit un nombre maximal spécifié de caractères à partir du lecteur actuel et écrit les données dans une mémoire tampon, en commençant à l'index spécifié.

public:
 virtual int Read(cli::array <char> ^ buffer, int index, int count);

public virtual int Read (char[] buffer, int index, int count);

abstract member Read : char[] * int * int -> int
override this.Read : char[] * int * int -> int

Public Overridable Function Read (buffer As Char(), index As Integer, count As Integer) As Integer

Paramètres

buffer

Char[]

Quand cette méthode est retournée, contient le tableau de caractères spécifié dont les valeurs comprises entre index et (index + count - 1) sont remplacées par les caractères lus dans la source actuelle.

index

Int32

Position dans buffer à partir de laquelle commencer l'écriture.

count

Int32

Nombre maximal de caractères à lire. Si la fin du lecteur est atteinte avant que le nombre de caractères spécifié soit lu dans la mémoire tampon, la méthode est retournée.

Retours

Int32

Nombre de caractères lus. Le nombre sera inférieur ou égal à count, selon les données disponibles dans le lecteur. Cette méthode retourne zéro si elle est appelée alors qu'il ne reste aucun caractère à lire.

Exceptions

ArgumentNullException

buffer a la valeur null.

ArgumentException

La longueur de la mémoire tampon moins index est inférieure à count.

ArgumentOutOfRangeException

index ou count est un nombre négatif.

ObjectDisposedException

Le TextReader est fermé.

IOException

Une erreur d’E/S se produit.

Remarques

Cette méthode retourne une fois que count les caractères sont lus ou que la fin du fichier est atteinte. ReadBlock est une version bloquante de cette méthode.

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 Read méthode, consultez la StreamReader.Read méthode .

Voir aussi

• Read(Char[], Int32, Int32)
• Read(Char[], Int32, Int32)
• E/S de fichier et de flux
• Procédure : lire le texte d’un fichier
• Procédure : écrire du texte dans un fichier