Bagikan melalui


Stream.ReadAtLeast(Span<Byte>, Int32, Boolean) Metode

Definisi

Membaca setidaknya jumlah minimum byte dari aliran saat ini dan memajukan posisi dalam aliran dengan jumlah byte yang dibaca.

public int ReadAtLeast (Span<byte> buffer, int minimumBytes, bool throwOnEndOfStream = true);
member this.ReadAtLeast : Span<byte> * int * bool -> int
Public Function ReadAtLeast (buffer As Span(Of Byte), minimumBytes As Integer, Optional throwOnEndOfStream As Boolean = true) As Integer

Parameter

buffer
Span<Byte>

Wilayah memori. Ketika metode ini kembali, konten wilayah ini digantikan oleh byte yang dibaca dari aliran saat ini.

minimumBytes
Int32

Jumlah minimum byte yang akan dibaca ke dalam buffer.

throwOnEndOfStream
Boolean

true untuk melemparkan pengecualian jika akhir aliran tercapai sebelum membaca minimumBytes byte; false untuk mengembalikan kurang dari minimumBytes saat akhir aliran tercapai. Default adalah true.

Mengembalikan

Jumlah total byte yang dibaca ke dalam buffer. Ini dijamin lebih besar dari atau sama dengan minimumBytes kapan throwOnEndOfStream adalah true. Ini akan kurang dari minimumBytes ketika akhir aliran tercapai dan throwOnEndOfStream adalah false. Ini bisa kurang dari jumlah byte yang dialokasikan dalam buffer jika banyak byte saat ini tidak tersedia.

Pengecualian

minimumBytes negatif, atau lebih besar dari panjang buffer.

throwOnEndOfStream adalah true dan akhir aliran dicapai sebelum membaca minimumBytes byte data.

Keterangan

Ketika minimumBytes adalah 0 (nol), operasi baca ini akan selesai tanpa menunggu data yang tersedia di aliran.

Berlaku untuk