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

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Sumber:

Stream.cs

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

Int32

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

ArgumentOutOfRangeException

minimumBytes negatif, atau lebih besar dari panjang buffer.

EndOfStreamException

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.