StreamReader.ReadBlock メソッド

定義

オーバーロード

名前 説明
ReadBlock(Span<Char>)

現在のストリームから文字を読み取り、データをバッファーに書き込みます。

ReadBlock(Char[], Int32, Int32)

現在のストリームから指定した最大文字数を読み取り、指定したインデックスから始まるデータをバッファーに書き込みます。

ReadBlock(Span<Char>)

現在のストリームから文字を読み取り、データをバッファーに書き込みます。

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>

このメソッドから制御が戻るときに、現在のソースから読み取られた文字に置き換えられた指定された文字範囲が格納されます。

返品

読み取られた文字数。 数値は、すべての入力文字が読み取られたかどうかに応じて、 buffer の長さ以下になります。

例外

buffernullです。

StreamReader は閉じられます。

I/O エラーが発生しました。

適用対象

ReadBlock(Char[], Int32, Int32)

現在のストリームから指定した最大文字数を読み取り、指定したインデックスから始まるデータをバッファーに書き込みます。

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

読み取る最大文字数。

返品

読み取られた文字数。 数値は、すべての入力文字が読み取られたかどうかに応じて、 count以下になります。

例外

buffernullです。

バッファーの長さから index を引いた値は、count未満です。

index または count が負の値です。

StreamReader は閉じられます。

I/O エラーが発生しました。

注釈

基になるストリームの位置は、 bufferに読み込まれた文字数だけ進みます。

このメソッドは、 count 文字が読み取られるか、ストリームの末尾に達するまでブロックします。 これは、 Readのブロック バージョンです。

適用対象