ReadByte Method

BufferedStream.ReadByte Method ()


Reads a byte from the underlying stream and returns the byte cast to an int, or returns -1 if reading from the end of the stream.

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

public override int ReadByte()

Return Value

Type: System.Int32

The byte cast to an int, or -1 if reading from the end of the stream.

Exception Condition

An I/O error occurs, such as the stream being closed.


The stream does not support reading.


Methods were called after the stream was closed.

Notes to Implementers:

The default implementation on Stream creates a new single-byte array and then calls Read. While this is formally correct, it is inefficient. Any stream with an internal buffer should override this method and provide a much more efficient version that reads the buffer directly, avoiding the extra array allocation on every call.

.NET Framework
Available since 1.1
Return to top
© 2015 Microsoft