System::IO::FileStream::ReadAsync Methode

FileStream::ReadAsync 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::FileStream::ReadAsync(const ArrayPtr<uint8_t> &buffer, int32_t offset, int32_t count, const Threading::CancellationToken &cancellationToken) override
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

System::IO::FileStream::Read Methode System::IO::FileStream::ReadByte Methode