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
| Name | Beschreibung |
|---|---|
| ReadExactlyAsync(Memory<Byte>, CancellationToken) |
Liest asynchron Bytes aus dem aktuellen Datenstrom, wechselt die Position innerhalb des Datenstroms, bis die |
| ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken) |
Liest asynchron die Anzahl der Bytes aus dem aktuellen Datenstrom, wechselt die Position innerhalb des Datenstroms |
ReadExactlyAsync(Memory<Byte>, CancellationToken)
- Quelle:
- Stream.cs
- Quelle:
- Stream.cs
- Quelle:
- Stream.cs
- Quelle:
- Stream.cs
- Quelle:
- Stream.cs
Liest asynchron Bytes aus dem aktuellen Datenstrom, wechselt die Position innerhalb des Datenstroms, bis die buffer Daten gefüllt sind, 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, das auf Abbruchanforderungen überwacht werden soll.
Gibt zurück
Eine Aufgabe, die den asynchronen Lesevorgang darstellt.
Ausnahmen
Das Ende des Datenstroms wird erreicht, bevor der bufferDatenstrom gefüllt wird.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Wenn buffer dieser Lesevorgang leer ist, wird dieser Lesevorgang abgeschlossen, ohne auf verfügbare Daten im Datenstrom zu warten.
Gilt für:
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)
- Quelle:
- Stream.cs
- Quelle:
- Stream.cs
- Quelle:
- Stream.cs
- Quelle:
- Stream.cs
- Quelle:
- Stream.cs
Liest asynchron die Anzahl der Bytes aus dem aktuellen Datenstrom, wechselt die Position innerhalb des Datenstroms count 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, in buffer dem mit dem Schreiben von Daten aus dem Datenstrom begonnen werden soll.
- count
- Int32
Die Anzahl der Bytes, die aus dem aktuellen Datenstrom gelesen werden sollen.
- cancellationToken
- CancellationToken
Das Token, das auf Abbruchanforderungen überwacht werden soll.
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 negativ.
-oder-
Der durch die Kombination angegebene offsetcount 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 die verfügbaren Daten im Datenstrom zu warten.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von ReadExactly(Byte[], Int32, Int32).
