System::IO::Stream::ReadAsync Methode

Stream::ReadAsync(const ArrayPtr<uint8_t>&, int32_t, int32_t) method

Liest asynchron eine Sequenz von Bytes aus dem aktuellen Stream, verschiebt die Position im Stream um die gelesene Anzahl von Bytes und überwacht Abbruchanforderungen.

RTaskPtr<int32_t> System::IO::Stream::ReadAsync(const ArrayPtr<uint8_t> &buffer, int32_t offset, int32_t count)
ParameterTypBeschreibung
Pufferconst ArrayPtr<uint8_t>&Das Byte-Array, in das die gelesenen Bytes geschrieben werden sollen.
offsetint32_tEine nullbasierte Position in buffer, an der das Schreiben beginnen soll.
countint32_tDie Anzahl der zu lesenden Bytes.

ReturnValue

Eine Aufgabe, die den asynchronen Lesevorgang darstellt. Der Wert des TResult‑Parameters enthält die Gesamtzahl der in den Puffer gelesenen Bytes. Der Ergebniswert kann kleiner sein als die angeforderte Byte‑Anzahl, wenn die derzeit verfügbare Byte‑Anzahl kleiner ist als die angeforderte, oder er kann 0 (null) sein, wenn das Ende des Streams erreicht wurde.

Siehe auch

Stream::ReadAsync(const ArrayPtr<uint8_t>&, int32_t, int32_t, const Threading::CancellationToken&) method

Liest asynchron eine Sequenz von Bytes aus dem aktuellen Stream, verschiebt die Position im Stream um die gelesene Anzahl von Bytes und überwacht Abbruchanforderungen.

virtual RTaskPtr<int32_t> System::IO::Stream::ReadAsync(const ArrayPtr<uint8_t> &buffer, int32_t offset, int32_t count, const Threading::CancellationToken &cancellationToken)
ParameterTypBeschreibung
Pufferconst ArrayPtr<uint8_t>&Das Byte-Array, in das die gelesenen Bytes geschrieben werden sollen.
offsetint32_tEine nullbasierte Position in buffer, an der das Schreiben beginnen soll.
countint32_tDie Anzahl der zu lesenden Bytes.
cancellationTokenconst Threading::CancellationToken&Das Token, das auf Abbruchanforderungen überwacht wird.

ReturnValue

Eine Aufgabe, die den asynchronen Lesevorgang darstellt. Der Wert des TResult‑Parameters enthält die Gesamtzahl der in den Puffer gelesenen Bytes. Der Ergebniswert kann kleiner sein als die angeforderte Byte‑Anzahl, wenn die derzeit verfügbare Byte‑Anzahl kleiner ist als die angeforderte, oder er kann 0 (null) sein, wenn das Ende des Streams erreicht wurde.

Siehe auch