TextReader.ReadBlockAsync Méthode

Définition

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

Surcharges

Nom Description
ReadBlockAsync(Memory<Char>, CancellationToken)

Lit de façon asynchrone les caractères du flux actuel et écrit les données dans une mémoire tampon.
ReadBlockAsync(Char[], Int32, Int32)

Lit de façon asynchrone 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é.

ReadBlockAsync(Memory<Char>, CancellationToken)

Lit de façon asynchrone les caractères du flux actuel et écrit les données dans une mémoire tampon.

public virtual System.Threading.Tasks.ValueTask<int> ReadBlockAsync(Memory<char> buffer, System.Threading.CancellationToken cancellationToken = default);
abstract member ReadBlockAsync : Memory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>
override this.ReadBlockAsync : Memory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>
Public Overridable Function ReadBlockAsync (buffer As Memory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Paramètres

buffer
Memory<Char>

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

cancellationToken
CancellationToken

Jeton à surveiller pour les demandes d’annulation. La valeur par défaut est None.

Retours

ValueTask<Int32>

Tâche de valeur qui représente l’opération de lecture asynchrone. La valeur du paramètre de type contient le nombre total de caractères lus dans la mémoire tampon. La valeur de résultat peut être inférieure au nombre de caractères demandé si le nombre de caractères actuellement disponibles est inférieur au nombre demandé, ou il peut être égal à 0 (zéro) si la fin du flux a été atteinte.

Exceptions

OperationCanceledException

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

S’applique à

ReadBlockAsync(Char[], Int32, Int32)

Lit de façon asynchrone 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 System::Threading::Tasks::Task<int> ^ ReadBlockAsync(cli::array <char> ^ buffer, int index, int count);
public virtual System.Threading.Tasks.Task<int> ReadBlockAsync(char[] buffer, int index, int count);
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task<int> ReadBlockAsync(char[] buffer, int index, int count);
abstract member ReadBlockAsync : char[] * int * int -> System.Threading.Tasks.Task<int>
override this.ReadBlockAsync : char[] * int * int -> System.Threading.Tasks.Task<int>
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member ReadBlockAsync : char[] * int * int -> System.Threading.Tasks.Task<int>
override this.ReadBlockAsync : char[] * int * int -> System.Threading.Tasks.Task<int>
Public Overridable Function ReadBlockAsync (buffer As Char(), index As Integer, count As Integer) As Task(Of 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 texte est atteinte avant que le nombre spécifié de caractères soit lu dans la mémoire tampon, la méthode actuelle retourne.

Retours

Task<Int32>

Tâche qui représente l’opération de lecture asynchrone. La valeur du TResult paramètre contient le nombre total d’octets lus dans la mémoire tampon. La valeur de résultat peut être inférieure au nombre d’octets demandé si le nombre d’octets actuellement disponibles est inférieur au nombre demandé, ou il peut être égal à 0 (zéro) si la fin du texte a été atteinte.

Attributs
ComVisibleAttribute

Exceptions

ArgumentNullException

buffer a la valeur null.

ArgumentOutOfRangeException

index ou count est négatif.

ArgumentException

La somme et indexcount est supérieure à la longueur de la mémoire tampon.

ObjectDisposedException

Le lecteur de texte a été supprimé.

InvalidOperationException

Le lecteur est actuellement utilisé par une opération de lecture précédente.

Remarques

La tâche ne se termine pas tant que le nombre de caractères spécifié par le count paramètre n’est pas lu ou que la fin du texte a été atteinte.

Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par ReadBlock(Char[], Int32, Int32).

Voir aussi

S’applique à