Freigeben über


Stream.ReadExactlyAsync Methode

Definition

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

Eine Aufgabe, die den asynchronen Lesevorgang darstellt.

Ausnahmen

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

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.

Gilt für:

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

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

Eine Aufgabe, die den asynchronen Lesevorgang darstellt.

Ausnahmen

buffer ist null.

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.

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

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).

Gilt für: