TextReader.ReadBlock TextReader.ReadBlock TextReader.ReadBlock TextReader.ReadBlock Method

定義

オーバーロード

ReadBlock(Span<Char>) ReadBlock(Span<Char>) ReadBlock(Span<Char>) ReadBlock(Span<Char>)
ReadBlock(Char[], Int32, Int32) ReadBlock(Char[], Int32, Int32) ReadBlock(Char[], Int32, Int32) ReadBlock(Char[], Int32, Int32)

指定した最大文字数を現在のテキスト リーダーから読み取り、バッファーの指定したインデックス位置にそのデータを書き込みます。Reads a specified maximum number of characters from the current text reader and writes the data to a buffer, beginning at the specified index.

ReadBlock(Span<Char>) ReadBlock(Span<Char>) ReadBlock(Span<Char>) 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>

戻り値

ReadBlock(Char[], Int32, Int32) ReadBlock(Char[], Int32, Int32) ReadBlock(Char[], Int32, Int32) ReadBlock(Char[], Int32, Int32)

指定した最大文字数を現在のテキスト リーダーから読み取り、バッファーの指定したインデックス位置にそのデータを書き込みます。Reads a specified maximum number of characters from the current text reader and writes the data to a buffer, beginning at the specified index.

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) までの値が、現在のソースから読み取られた文字に置き換えられています。When this method returns, this parameter contains the specified character array with the values between index and (index + count -1) replaced by the characters read from the current source.

index
Int32 Int32 Int32 Int32

書き込みを開始する buffer 内の位置。The position in buffer at which to begin writing.

count
Int32 Int32 Int32 Int32

読み取り対象の最大文字数。The maximum number of characters to read.

戻り値

読み取られた文字数。The number of characters that have been read. この数値は、すべての入力文字が読み取られたかどうかによって異なりますが、count 以下の数値になります。The number will be less than or equal to count, depending on whether all input characters have been read.

例外

バッファーの長さから index を引いた値が count 未満です。The buffer length minus index is less than count.

index または count が負の値です。index or count is negative.

I/O エラーが発生します。An I/O error occurs.

注釈

基になるテキストリーダーの位置は、にbuffer読み込まれた文字数だけ進んでいます。The position of the underlying text reader is advanced by the number of characters that were read into buffer.

メソッドは、いずれかcountの文字が読み込まれるか、すべての文字が読み取られるまでブロックします。The method blocks until either count characters are read, or all characters have been read. これは、のReadブロッキングバージョンです。This is a blocking version of Read.

こちらもご覧ください

適用対象