Stream.ReadByte Method ()
Reads a byte from the stream and advances the position within the stream by one byte, or returns -1 if at the end of the stream.
Assembly: mscorlib (in mscorlib.dll)
Return Value
Type: System.Int32The unsigned byte cast to an Int32, or -1 if at the end of the stream.
| Exception | Condition |
|---|---|
| NotSupportedException | The stream does not support reading. |
| ObjectDisposedException | Methods were called after the stream was closed. |
Use the CanRead property to determine whether the current instance supports reading.
Attempts to manipulate the stream after the stream has been closed could throw an ObjectDisposedException.
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.
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1