TextReader.Read Méthode

Définition

Espace de noms:
System.IO
Assemblys:
mscorlib.dll, System.IO.dll
Assembly:
mscorlib.dll
Assembly:
System.IO.dll
Assembly:
netstandard.dll

Lit les données du lecteur de texte.

Surcharges

Nom Description
Read()

Lit le caractère suivant du lecteur de texte et avance la position du caractère d’un caractère.
Read(Span<Char>)

Lit les caractères du lecteur actuel et écrit les données dans la mémoire tampon spécifiée.
Read(Char[], Int32, Int32)

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

Read()

Lit le caractère suivant du lecteur de texte et avance la position du caractère 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 si aucun plus de caractères n’est disponible. L'implémentation par défaut retourne -1.

Exceptions

ObjectDisposedException

La TextReader fermeture est terminée.

IOException

Une erreur d’E/S se produit.

Remarques

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

Voir aussi

S’applique à

Read(Span<Char>)

Lit les caractères 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>

Lorsque cette méthode est retournée, contient l’étendue spécifiée de caractères remplacée par les caractères lus à partir de la source actuelle.

Retours

Int32

Nombre de caractères lus. Le nombre est inférieur ou égal à la buffer longueur, selon que les données sont disponibles dans le lecteur. Cette méthode retourne 0 (zéro) si elle est appelée lorsqu’aucun autre caractère n’est laissé à lire.

Exceptions

ArgumentNullException

buffer a la valeur null.

IOException

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

S’applique à

Read(Char[], Int32, Int32)

Lit un nombre maximal de caractères spécifié à 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[]

Lorsque cette méthode retourne, contient le tableau de caractères spécifié avec les valeurs comprises entre index et (index + count - 1) remplacées par les caractères lus à partir de la source actuelle.

index
Int32

Position dans buffer laquelle commencer l’écriture.

count
Int32

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

Retours

Int32

Nombre de caractères lus. Le nombre est inférieur ou égal à count, selon que les données sont disponibles dans le lecteur. Cette méthode retourne 0 (zéro) si elle est appelée lorsqu’aucun autre caractère n’est laissé à 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 négatif.

ObjectDisposedException

La TextReader fermeture est terminée.

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

Voir aussi

S’applique à