Partager via


Stream.ReadExactlyAsync Méthode

Définition

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
Source:
Stream.cs
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

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

Exceptions

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

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.

S’applique à

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

Source:
Stream.cs
Source:
Stream.cs
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

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

Exceptions

buffer a la valeur null.

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.

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

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 le é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 manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par ReadExactly(Byte[], Int32, Int32).

S’applique à