Stream.ReadExactlyAsync Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Überlädt

ReadExactlyAsync(Memory<Byte>, CancellationToken)	Liest Bytes asynchron aus dem aktuellen Stream, verschiekt die Position innerhalb des Datenstroms, bis der buffer gefüllt ist, und überwacht Abbruchanforderungen.
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)	Liest count die Anzahl von Bytes asynchron aus dem aktuellen Stream, erhöht die Position innerhalb des Datenstroms und überwacht Abbruchanforderungen.

ReadExactlyAsync(Memory<Byte>, CancellationToken)

Quelle:

Stream.cs

Liest Bytes asynchron aus dem aktuellen Stream, verschiekt die Position innerhalb des Datenstroms, bis der buffer gefüllt ist, und überwacht Abbruchanforderungen.

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

Parameter

buffer

Memory<Byte>

Der Puffer, in den die Daten geschrieben werden sollen.

cancellationToken

CancellationToken

Das Token zum Überwachen von Abbruchanforderungen.

Gibt zurück

ValueTask

Eine Aufgabe, die den asynchronen Lesevorgang darstellt.

Ausnahmen

EndOfStreamException

Das Ende des Datenstroms wird erreicht, bevor der bufferaufgefüllt wird.

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Wenn buffer leer ist, wird dieser Lesevorgang abgeschlossen, ohne auf verfügbare Daten im Stream zu warten.

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

Quelle:

Stream.cs

Liest count die Anzahl von Bytes asynchron aus dem aktuellen Stream, erhöht die Position innerhalb des Datenstroms und überwacht Abbruchanforderungen.

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

Parameter

buffer

Byte[]

Der Puffer, in den die Daten geschrieben werden sollen.

offset

Int32

Der Byteoffset im buffer, ab dem Daten aus dem Stream geschrieben werden.

count

Int32

Die Anzahl der Bytes, die aus dem aktuellen Stream gelesen werden sollen.

cancellationToken

CancellationToken

Das Token zum Überwachen von Abbruchanforderungen.

Gibt zurück

ValueTask

Eine Aufgabe, die den asynchronen Lesevorgang darstellt.

Ausnahmen

ArgumentNullException

buffer ist null.

ArgumentOutOfRangeException

offset liegt außerhalb der Grenzen von buffer.

- oder -

count ist ein negativer Wert.

- oder -

Der durch die Kombination von offset und count angegebene Bereich überschreitet die Länge von buffer.

EndOfStreamException

Das Ende des Datenstroms wird erreicht, bevor die Anzahl der Bytes gelesen count wird.

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Wenn count 0 (null) ist, wird dieser Lesevorgang abgeschlossen, ohne auf verfügbare Daten im Stream zu warten.

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden ReadExactly(Byte[], Int32, Int32).