StreamReader.ReadBlock Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Surcharges

ReadBlock(Char[], Int32, Int32)	Lit un nombre maximal spécifié de caractères à partir du flux 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)

Source:

StreamReader.cs

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

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

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

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

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

Paramètres

buffer

Char[]

Quand cette méthode retourne un résultat, 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 StreamReader est fermé.

IOException

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

Remarques

La position du flux 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 count les deux caractères soient lus ou que la fin du flux ait été atteinte. Il s’agit d’une version bloquante de Read.

ReadBlock(Span<Char>)

Source:

StreamReader.cs

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

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

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

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

Public Overrides 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.