StreamReader.ReadBlock 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

多載

ReadBlock(Char[], Int32, Int32)	從目前資料流讀取指定的最大字元數目，並從指定的索引開始將資料寫入緩衝區。
ReadBlock(Span<Char>)	從目前的資料流讀取字元，並將資料寫入至緩衝區。

ReadBlock(Char[], Int32, Int32)

來源:

StreamReader.cs

從目前資料流讀取指定的最大字元數目，並從指定的索引開始將資料寫入緩衝區。

public:
 override int ReadBlock(cli::array <char> ^ buffer, int index, int count);

public override int ReadBlock (char[] buffer, int index, int count);

override this.ReadBlock : char[] * int * int -> int

Public Overrides Function ReadBlock (buffer As Char(), index As Integer, count As Integer) As Integer

參數

buffer

Char[]

當這個方法返回時，會包含具有介於 index 和 (index + count - 1) 的值之指定字元陣列，這個值是由從目前來源讀取的字元所取代。

index

Int32

buffer 中要開始寫入的位置。

count

Int32

要讀取的字元數上限。

傳回

Int32

已經讀取的字元數目。 數目將小於或等於 count，取決於是否已經讀取所有輸入字元。

例外狀況

ArgumentNullException

buffer 為 null。

ArgumentException

緩衝區長度減去 index 會小於 count。

ArgumentOutOfRangeException

index 或 count 為負。

ObjectDisposedException

StreamReader 已關閉。

IOException

發生 I/O 錯誤。

備註

基礎資料流程的位置會由讀取到 buffer 的字元數進階。

方法會封鎖直到 count 讀取字元或到達資料流程結尾為止。 這是 的 Read 封鎖版本。

ReadBlock(Span<Char>)

來源:

StreamReader.cs

從目前的資料流讀取字元，並將資料寫入至緩衝區。

public:
 override int ReadBlock(Span<char> buffer);

public override int ReadBlock (Span<char> buffer);

override this.ReadBlock : Span<char> -> int

Public Overrides Function ReadBlock (buffer As Span(Of Char)) As Integer

參數

buffer

Span<Char>

當這個方法傳回時，會包含讀取自目前來源之字元所取代的指定字元範圍。

傳回

Int32

已經讀取的字元數目。 取決於是否已讀取所有輸入字元，數目會小於或等於 buffer 的長度。

例外狀況

ArgumentNullException

buffer 為 null。

ObjectDisposedException

StreamReader 已關閉。

IOException

發生 I/O 錯誤。