BinaryReader.ReadByte Method
Reads the next byte from the current stream and advances the current position of the stream by one byte.
Assembly: mscorlib (in mscorlib.dll)
| Exception | Condition |
|---|---|
| EndOfStreamException | The end of the stream is reached. |
| ObjectDisposedException | The stream is closed. |
| IOException | An I/O error occurs. |
BinaryReader does not restore the file position after an unsuccessful read.
Because of data formatting conflicts, using this method with the following encodings is not recommended:
UTF-7
ISO-2022-JP
ISCII
For a list of common I/O tasks, see Common I/O Tasks.
The following code example shows how to write binary data using memory as a backing store, and then verify that the data was written correctly.
using System; using System.IO; class BinaryRW { static void Main() { int i = 0; // Create random data to write to the stream. byte[] writeArray = new byte[1000]; new Random().NextBytes(writeArray); BinaryWriter binWriter = new BinaryWriter(new MemoryStream()); BinaryReader binReader = new BinaryReader(binWriter.BaseStream); try { // Write the data to the stream. Console.WriteLine("Writing the data."); for(i = 0; i < writeArray.Length; i++) { binWriter.Write(writeArray[i]); } // Set the stream position to the beginning of the stream. binReader.BaseStream.Position = 0; // Read and verify the data from the stream. for(i = 0; i < writeArray.Length; i++) { if(binReader.ReadByte() != writeArray[i]) { Console.WriteLine("Error writing the data."); return; } } Console.WriteLine("The data was written and verified."); } // Catch the EndOfStreamException and write an error message. catch(EndOfStreamException e) { Console.WriteLine("Error writing the data.\n{0}", e.GetType().Name); } } }
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.