Peek Method

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.

Namespace:  System.IO
Assembly:  mscorlib (in mscorlib.dll)

'Declaration
Public Overridable Function Peek As Integer

Return Value

Type: System.Int32
An integer representing the next character to be read, or -1 if no more characters are available or the stream does not support seeking.

ExceptionCondition
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.

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2016 Microsoft