TextReader.ReadBlock 方法

定義

命名空間:

System.IO

組件:

System.IO.dll

組件:

System.Runtime.dll

組件:

System.Runtime.Extensions.dll

組件:

mscorlib.dll

組件:

netstandard.dll

多載

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

ReadBlock(Char[], Int32, Int32)

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

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

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

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

Public Overridable 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

TextReader 已關閉。

IOException

發生 I/O 錯誤。

備註

基礎文字讀取器的位置會由讀取到 buffer 的字元數進階。

方法會封鎖直到 count 讀取字元或讀取所有字元為止。 這是 的 Read 封鎖版本。

另請參閱

• ReadBlock(Char[], Int32, Int32)
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

ReadBlock(Span<Char>)

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

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

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

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

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

參數

buffer

Span<Char>

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

傳回

Int32

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

例外狀況

ArgumentNullException

buffer 為 null。

ObjectDisposedException

StreamReader 已關閉。

IOException

發生 I/O 錯誤。