Stream.ReadExactlyAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| ReadExactlyAsync(Memory<Byte>, CancellationToken) |
Liest Bytes asynchron aus dem aktuellen Stream, verschiekt die Position innerhalb des Datenstroms, bis der |
| ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken) |
Liest |
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.ValueTaskPublic Function ReadExactlyAsync (buffer As Memory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTaskParameter
- 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.ValueTaskPublic Function ReadExactlyAsync (buffer As Byte(), offset As Integer, count As Integer, Optional cancellationToken As CancellationToken = Nothing) As ValueTaskParameter
- 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).
