Stream.ReadAtLeast(Span<Byte>, Int32, Boolean) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
至少从当前流中读取最小字节数,并通过读取的字节数提升流中的位置。
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
参数
- minimumBytes
- Int32
要读入缓冲区的最小字节数。
- throwOnEndOfStream
- Boolean
true 如果在读取 minimumBytes 字节之前到达流的末尾,则引发异常; false 返回的 minimumBytes 小于到达流的末尾的时间。
默认值为 true。
返回
读取到缓冲区中的字节总数。 这可以保证大于或等于minimumBytes何时throwOnEndOfStreamtrue。 这小于 minimumBytes 到达流的末尾且 throwOnEndOfStream 已 false达到时。 如果缓冲区中分配的字节数当前不可用,这可以小于该数目的字节数。
例外
minimumBytes 为负数,或大于长度 buffer。
throwOnEndOfStream 是在 true 读取 minimumBytes 数据字节之前到达流的末尾。
注解
如果 minimumBytes 为 0(零),则此读取操作将完成,而无需等待流中的可用数据。