TextReader.Read メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
テキスト リーダーからデータを読み取ります。
オーバーロード
| 名前 | 説明 |
|---|---|
| Read() |
テキスト リーダーから次の文字を読み取り、文字位置を 1 文字進めます。 |
| Read(Span<Char>) |
現在のリーダーから文字を読み取り、指定したバッファーにデータを書き込みます。 |
| Read(Char[], Int32, Int32) |
現在のリーダーから指定した最大文字数を読み取り、指定したインデックスから始まるデータをバッファーに書き込みます。 |
Read()
- ソース:
- TextReader.cs
- ソース:
- TextReader.cs
- ソース:
- TextReader.cs
- ソース:
- TextReader.cs
- ソース:
- TextReader.cs
テキスト リーダーから次の文字を読み取り、文字位置を 1 文字進めます。
public:
virtual int Read();public virtual int Read();abstract member Read : unit -> int
override this.Read : unit -> intPublic Overridable Function Read () As Integer返品
テキスト リーダーの次の文字。使用できる文字がなくなった場合は -1。 既定の実装では、-1 が返されます。
例外
TextReader は閉じられます。
I/O エラーが発生しました。
注釈
TextReader クラスは抽象クラスです。 そのため、コードではインスタンス化しません。 Read メソッドの使用例については、StreamReader.Read メソッドを参照してください。
こちらもご覧ください
適用対象
Read(Span<Char>)
- ソース:
- TextReader.cs
- ソース:
- TextReader.cs
- ソース:
- TextReader.cs
- ソース:
- TextReader.cs
- ソース:
- TextReader.cs
現在のリーダーから文字を読み取り、指定したバッファーにデータを書き込みます。
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> -> intPublic Overridable Function Read (buffer As Span(Of Char)) As Integerパラメーター
返品
読み取られた文字数。 データがリーダー内で使用できるかどうかに応じて、 buffer の長さ以下になります。 読み取る文字が残っていないときに呼び出された場合、このメソッドは 0 (ゼロ) を返します。
例外
buffer は nullです。
ストリームから読み取られた文字数が、 bufferの長さを超えています。
適用対象
Read(Char[], Int32, Int32)
- ソース:
- TextReader.cs
- ソース:
- TextReader.cs
- ソース:
- TextReader.cs
- ソース:
- TextReader.cs
- ソース:
- TextReader.cs
現在のリーダーから指定した最大文字数を読み取り、指定したインデックスから始まるデータをバッファーに書き込みます。
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 -> intPublic Overridable Function Read (buffer As Char(), index As Integer, count As Integer) As Integerパラメーター
- buffer
- Char[]
このメソッドから制御が戻るときに、指定された文字配列が格納され、 index から (index + count - 1) までの値が現在のソースから読み取られた文字に置き換えられます。
- index
- Int32
buffer書き込みを開始する位置。
- count
- Int32
読み取る最大文字数。 指定した文字数がバッファーに読み込まれる前にリーダーの末尾に達すると、メソッドは戻ります。
返品
読み取られた文字数。 リーダー内でデータを使用できるかどうかに応じて、数値は count以下になります。 読み取る文字が残っていないときに呼び出された場合、このメソッドは 0 (ゼロ) を返します。
例外
buffer は nullです。
バッファーの長さから index を引いた値は、count未満です。
index または count が負の値です。
TextReader は閉じられます。
I/O エラーが発生しました。
注釈
このメソッドは、 count 文字が読み取られたか、ファイルの末尾に達した後に返されます。
ReadBlock は、このメソッドのブロック バージョンです。
TextReader クラスは抽象クラスです。 そのため、コードではインスタンス化しません。 Read メソッドの使用例については、StreamReader.Read メソッドを参照してください。
こちらもご覧ください
- Read(Char[], Int32, Int32)
- Read(Char[], Int32, Int32)
- ファイルおよびストリーム入出力
- 方法: ファイルからテキストを読み取る
- 方法: ファイルにテキストを書き込む
