The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.
BufferedStream::ReadByte Method ()
.NET Framework (current version)
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.
Assembly: mscorlib (in mscorlib.dll)
Return Value
Type: System::Int32The byte cast to an int, or -1 if reading from the end of the stream.
| Exception | Condition |
|---|---|
| IOException | An I/O error occurs, such as the stream being closed. |
| NotSupportedException | The stream does not support reading. |
| ObjectDisposedException | 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
Available since 1.1
Show: