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
bufferconst ArrayPtr<uint8_t>&Das Byte-Array, in das die gelesenen Bytes geschrieben werden sollen.
Offsetint32_tEine 0-basierte 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

Ein Task, der den asynchronen Lesevorgang repräsentiert. 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