Stream.ReadExactlyAsync Méthode

Définition

Espace de noms:
System.IO
Assemblys:
netstandard.dll, System.Runtime.dll

Surcharges

Nom Description
ReadExactlyAsync(Memory<Byte>, CancellationToken)

Lit de façon asynchrone les octets du flux actuel, avance la position dans le flux jusqu’à ce que le buffer flux soit rempli et surveille les demandes d’annulation.
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)

Lit de façon 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
Source:
Stream.cs
Source:
Stream.cs

Lit de façon asynchrone les octets du flux actuel, avance la position dans le flux jusqu’à ce que le buffer flux 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 dans laquelle écrire les données.

cancellationToken
CancellationToken

Jeton à surveiller pour les demandes 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

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

S’applique à

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

Source:
Stream.cs
Source:
Stream.cs
Source:
Stream.cs
Source:
Stream.cs
Source:
Stream.cs

Lit de façon 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 dans laquelle écrire les données.

offset
Int32

Décalage d’octet dans buffer lequel commencer l’écriture de données à partir du flux.

count
Int32

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

cancellationToken
CancellationToken

Jeton à surveiller pour les demandes 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 négatif.

- ou -

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 de lire count le 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 0 (zéro), cette opération de lecture est terminée sans attendre que les données disponibles soient disponibles dans le flux.

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 ReadExactly(Byte[], Int32, Int32).

S’applique à