Export (0) Print
Expand All

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 input stream.

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

public virtual int Peek ()
public int Peek ()
public function Peek () : int
Not applicable.

Return Value

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

Exception typeCondition

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 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

XNA Framework

Supported in: 1.0

Community Additions

ADD
Show:
© 2014 Microsoft