TextReader.Peek Method
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
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 input stream.
Assembly: mscorlib (in mscorlib.dll)
Return Value
Type: System.Int32An integer representing the next character to be read, or -1 if no more characters are available or the stream does not support seeking.
| Exception | Condition |
|---|---|
| ObjectDisposedException | The TextReader is closed. |
| IOException | An I/O error occurs. |
The Peek method returns an integer value in order to determine whether the end of the file, or another error has occurred. This allows a user to first check if the returned value is -1 before casting it to a Char type.
The current position of the TextReader is not changed by this operation. The returned value is -1 if no more characters are available. The default implementation returns -1.