TextReader.Peek TextReader.Peek TextReader.Peek TextReader.Peek Method

定義

リーダーや文字の読み取り元の状態を変更せずに、次の文字を読み取ります。Reads the next character without changing the state of the reader or the character source. リーダーから実際に文字を読み取らずに次の文字を返します。Returns the next available character without actually reading it from the reader.

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。An integer representing the next character to be read, or -1 if no more characters are available or the reader does not support seeking.

例外

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

注釈

Peekメソッドは、ファイル、または別のエラーの終了が発生したかどうかを確認するには整数値を返します。The Peek method returns an integer value in order to determine whether the end of the file, or another error has occurred. これにより、ユーザーをまず確認かどうか、返される値は-1 にキャストする前に、Char型。This allows a user to first check if the returned value is -1 before casting it to a Char type.

現在の位置、TextReaderこの操作では変更されません。The current position of the TextReader is not changed by this operation. 可能な文字がない場合、返される値は-1 です。The returned value is -1 if no more characters are available. 既定の実装では、-1 が返されます。The default implementation returns -1.

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

適用対象

こちらもご覧ください