TextReader.ReadBlock Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.IO.dll

Assembly:

System.Runtime.dll

Assembly:

System.Runtime.Extensions.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Surcharges

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

ReadBlock(Char[], Int32, Int32)

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

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

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

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

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

Paramètres

buffer

Char[]

Lorsque cette méthode est retournée, ce paramètre 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.

Retours

Int32

Nombre de caractères lus. Le nombre sera inférieur ou égal à count, selon que tous les caractères d'entrée ont été lus ou non.

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

La position du lecteur de texte sous-jacent est avancée par le nombre de caractères qui ont été lus dans buffer.

La méthode se bloque jusqu’à ce que les count caractères soient lus ou que tous les caractères aient été lus. Il s’agit d’une version bloquante de Read.

Voir aussi

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

ReadBlock(Span<Char>)

Lit les caractères à partir du flux actuel et écrit les données dans une mémoire tampon.

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

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

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

Public Overridable Function ReadBlock (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 que tous les caractères d'entrée ont été lus ou non.

Exceptions

ArgumentNullException

buffer a la valeur null.

ObjectDisposedException

Le StreamReader est fermé.

IOException

Une erreur d'E/S s'est produite.