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を読み取る前に到達した場合に例外をスローする場合は a0/>。ストリームの末尾に達したときにminimumBytes未満を返すfalse。 既定値は true です。

返品

バッファーに読み込まれるバイトの合計数。 これは、throwOnEndOfStreamtrueされるときに、minimumBytes以上であることが保証されます。 ストリームの末尾に達し、throwOnEndOfStreamfalse場合、これはminimumBytes未満になります。 この値は、バッファーに割り当てられているバイト数より小さい場合があります (そのバイト数が現在使用できない場合)。

例外

minimumBytes が負の値であるか、 bufferの長さを超えています。

throwOnEndOfStreamtrue され、ストリームの末尾に到達してから、 minimumBytes バイトのデータを読み取ります。

注釈

minimumBytesが 0 (ゼロ) の場合、ストリーム内の使用可能なデータを待たずに、この読み取り操作が完了します。

適用対象