TextReader.Peek メソッド

定義

リーダーまたは文字ソースの状態を変更せずに、次の文字を読み取ります。 リーダーから実際に読み取ることなく、次に使用可能な文字を返します。

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

返品

読み取る次の文字を表す整数。使用できる文字がなくなった場合、またはリーダーがシークをサポートしていない場合に -1。

例外

TextReader は閉じられます。

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

注釈

Peek メソッドは、ファイルの末尾または別のエラーが発生したかどうかを判断するために整数値を返します。 これにより、ユーザーは、 Char 型にキャストする前に、返された値が -1 されているかどうかを最初に確認できます。

この操作では、 TextReader の現在位置は変更されません。 使用できる文字がそれ以上ない場合、戻り値は -1 されます。 既定の実装では、-1 が返されます。

TextReader クラスは抽象クラスです。 そのため、コードではインスタンス化しません。 Peek メソッドの使用例については、StreamReader.Peek メソッドを参照してください。

適用対象

こちらもご覧ください