Stream.ReadExactlyAsync Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Surcharges

ReadExactlyAsync(Memory<Byte>, CancellationToken)	Lit de manière asynchrone les octets du flux actuel, avance la position dans le flux jusqu’à ce que le buffer soit rempli et surveille les demandes d’annulation.
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)	Lit de manière asynchrone le nombre d’octets count du flux actuel, avance la position dans le flux et surveille les demandes d’annulation.

ReadExactlyAsync(Memory<Byte>, CancellationToken)

Source:

Stream.cs

Lit de manière asynchrone les octets du flux actuel, avance la position dans le flux jusqu’à ce que le buffer soit rempli et surveille les demandes d’annulation.

public System.Threading.Tasks.ValueTask ReadExactlyAsync (Memory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);

member this.ReadExactlyAsync : Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ReadExactlyAsync (buffer As Memory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Paramètres

buffer

Memory<Byte>

Mémoire tampon où écrire les données.

cancellationToken

CancellationToken

Jeton pour surveiller les requêtes d'annulation.

Retours

ValueTask

Tâche qui représente l'opération de lecture asynchrone.

Exceptions

EndOfStreamException

La fin du flux est atteinte avant de remplir le buffer.

OperationCanceledException

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

Remarques

Lorsque buffer est vide, cette opération de lecture est terminée sans attendre les données disponibles dans le flux.

ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)

Source:

Stream.cs

Lit de manière asynchrone le nombre d’octets count du flux actuel, avance la position dans le flux et surveille les demandes d’annulation.

public System.Threading.Tasks.ValueTask ReadExactlyAsync (byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken = default);

member this.ReadExactlyAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ReadExactlyAsync (buffer As Byte(), offset As Integer, count As Integer, Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Paramètres

buffer

Byte[]

Mémoire tampon où écrire les données.

offset

Int32

Dans buffer, décalage d'octet auquel commencer l'écriture des données à partir du flux.

count

Int32

Nombre d’octets à lire à partir du flux actuel.

cancellationToken

CancellationToken

Jeton pour surveiller les requêtes d'annulation.

Retours

ValueTask

Tâche qui représente l'opération de lecture asynchrone.

Exceptions

ArgumentNullException

buffer a la valeur null.

ArgumentOutOfRangeException

offset est en dehors des limites de buffer.

- ou -

count est un nombre négatif.

- ou -

La plage spécifiée par la combinaison de offset et count dépasse la longueur de buffer.

EndOfStreamException

La fin du flux est atteinte avant la lecture count du nombre d’octets.

OperationCanceledException

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

Remarques

Lorsque count la valeur est égale à 0 (zéro), cette opération de lecture est terminée sans attendre les données disponibles dans le flux.

Cette méthode stocke dans la tâche toutes les exceptions de 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 sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par ReadExactly(Byte[], Int32, Int32).