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 エラーが発生しました。