Stream.ReadExactly 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

多載

ReadExactly(Span<Byte>)	從目前的數據流讀取位元組，並將數據流內的位置往前移，直到 buffer 填滿為止。
ReadExactly(Byte[], Int32, Int32)	count從目前的數據流讀取位元組數目，並將數據流中的位置往前移。

ReadExactly(Span<Byte>)

來源:

Stream.cs

從目前的數據流讀取位元組，並將數據流內的位置往前移，直到 buffer 填滿為止。

public:
 void ReadExactly(Span<System::Byte> buffer);

public void ReadExactly (Span<byte> buffer);

member this.ReadExactly : Span<byte> -> unit

Public Sub ReadExactly (buffer As Span(Of Byte))

參數

buffer

Span<Byte>

記憶體區域。 當這個方法傳回時，這個區域的內容會由從目前數據流讀取的位元組取代。

例外狀況

EndOfStreamException

在填滿 buffer之前，會到達數據流的結尾。

備註

當 是空的時 buffer ，此讀取作業將會完成，而不需要等候數據流中的可用數據。

ReadExactly(Byte[], Int32, Int32)

來源:

Stream.cs

count從目前的數據流讀取位元組數目，並將數據流中的位置往前移。

public:
 void ReadExactly(cli::array <System::Byte> ^ buffer, int offset, int count);

public void ReadExactly (byte[] buffer, int offset, int count);

member this.ReadExactly : byte[] * int * int -> unit

Public Sub ReadExactly (buffer As Byte(), offset As Integer, count As Integer)

參數

buffer

Byte[]

位元組陣列。 當這個方法傳回時，緩衝區會包含指定的位元組陣列，其值介於 offset 和 (offset + count - 1) 由從目前數據流讀取的位元組取代。

offset

Int32

開始儲存從目前資料流讀取資料的 buffer 位元組位移。

count

Int32

要從目前數據流讀取的位元元組數目。

例外狀況

ArgumentNullException

buffer 為 null。

ArgumentOutOfRangeException

offset 不在 buffer 範圍內。

-或-

count 為負。

-或-

和 count 的組合offset所指定的範圍超過的buffer長度。

EndOfStreamException

讀取位元組數目之前 count ，會到達數據流結尾。

備註

當 count 為 0 (零) 時，此讀取作業將會完成，而不需要等待數據流中的可用數據。