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

定义

至少从当前流中读取最小字节数,并通过读取的字节数提升流中的位置。

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

参数

buffer
Span<Byte>

内存区域。 此方法返回时,此区域的内容将替换为从当前流中读取的字节。

minimumBytes
Int32

要读入缓冲区的最小字节数。

throwOnEndOfStream
Boolean

true 如果在读取 minimumBytes 字节之前到达流的末尾,则引发异常; false 返回的 minimumBytes 小于到达流的末尾的时间。 默认值为 true

返回

读取到缓冲区中的字节总数。 这可以保证大于或等于minimumBytes何时throwOnEndOfStreamtrue。 这小于 minimumBytes 到达流的末尾且 throwOnEndOfStreamfalse达到时。 如果缓冲区中分配的字节数当前不可用,这可以小于该数目的字节数。

例外

minimumBytes 为负数,或大于长度 buffer

throwOnEndOfStream 是在 true 读取 minimumBytes 数据字节之前到达流的末尾。

注解

如果 minimumBytes 为 0(零),则此读取操作将完成,而无需等待流中的可用数据。

适用于