TextReader.Read TextReader.Read TextReader.Read TextReader.Read Method

定義

テキスト リーダーからデータを読み取ります。Reads data from the text reader.

オーバーロード

Read() Read() Read() Read()

テキスト リーダーから次の文字を読み取り、1 文字分だけ文字位置を進めます。Reads the next character from the text reader and advances the character position by one character.

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

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

Read() Read() Read() Read()

テキスト リーダーから次の文字を読み取り、1 文字分だけ文字位置を進めます。Reads the next character from the text reader and advances the character position by one character.

public:
 virtual int Read();
public virtual int Read ();
abstract member Read : unit -> int
override this.Read : unit -> int
Public Overridable Function Read () As Integer

戻り値

テキスト リーダーからの次の文字。それ以上読み取り可能な文字がない場合は -1。The next character from the text reader, or -1 if no more characters are available. 既定の実装では、-1 が返されます。The default implementation returns -1.

例外

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

注釈

TextReader クラスは抽象クラスです。The TextReader class is an abstract class. そのため、コードでそれをインスタンス化することはありません。Therefore, you do not instantiate it in your code. 使用する例については、Readメソッドを参照してください、StreamReader.Readメソッド。For an example of using the Read method, see the StreamReader.Read method.

こちらもご覧ください

Read(Span<Char>) Read(Span<Char>) Read(Span<Char>) Read(Span<Char>)

public:
 virtual int Read(Span<char> buffer);
public virtual int Read (Span<char> buffer);
abstract member Read : Span<char> -> int
override this.Read : Span<char> -> int
Public Overridable Function Read (buffer As Span(Of Char)) As Integer

パラメーター

buffer
Span<Char>

戻り値

Read(Char[], Int32, Int32) Read(Char[], Int32, Int32) Read(Char[], Int32, Int32) Read(Char[], Int32, Int32)

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

public:
 virtual int Read(cli::array <char> ^ buffer, int index, int count);
public virtual int Read (char[] buffer, int index, int count);
abstract member Read : char[] * int * int -> int
override this.Read : char[] * int * int -> int
Public Overridable Function Read (buffer As Char(), index As Integer, count As Integer) As Integer

パラメーター

buffer
Char[]

このメソッドが戻るとき、指定した文字配列の index から (index + count - 1) までの値が、現在のソースから読み取られた文字に置き換えられます。When this method returns, 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. 指定された文字数をバッファーに読み取る前にリーダーの末尾に到達した場合、メソッドは制御を返します。If the end of the reader is reached before the specified number of characters is read into the buffer, the method returns.

戻り値

読み取られた文字数。The number of characters that have been read. この数値は、リーダー内に使用できるデータがあるかどうかによって異なりますが、count 以下の数値になります。The number will be less than or equal to count, depending on whether the data is available within the reader. 読み取り対象の文字がない場合にこのメソッドを呼び出すと、0 (ゼロ) が返されます。This method returns 0 (zero) if it is called when no more characters are left to read.

例外

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

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

注釈

いずれかの後にこのメソッドが戻るcount文字が読み取られたまたはファイルの末尾に到達します。This method returns after either count characters are read or the end of the file is reached. ReadBlock このメソッドのブロックのバージョンです。is a blocking version of this method.

TextReader クラスは抽象クラスです。The TextReader class is an abstract class. そのため、コードでそれをインスタンス化することはありません。Therefore, you do not instantiate it in your code. 使用する例については、Readメソッドを参照してください、StreamReader.Readメソッド。For an example of using the Read method, see the StreamReader.Read method.

こちらもご覧ください

適用対象