C# MemoryStream: Use Stream on Byte Array

Use the MemoryStream type from System.IO to use stream methods on data in memory.

MemoryStream represents a pure, in-memory stream of data. It is found in the System.IO namespace. It is derived from the Stream type. It is useful when using BinaryReader. It can be reset—this leads to performance improvements.Stream

First, let's examine this program from a higher level. The program physically reads in the bytes of specified file into the computer's memory. No more disk accesses occur after this.

Info: A MemoryStream is constructed from this byte array containing the file's data.

Then: The MemoryStream is used as a backing store for the BinaryReader type, which acts upon the in-memory representation.

Byte Array BinaryReader

C# program that uses the MemoryStream type using System; using System.IO; class Program { static void Main() { // Read all bytes in from a file on the disk. byte[] file = File.ReadAllBytes("C:\\ICON1.png"); // Create a memory stream from those bytes. using (MemoryStream memory = new MemoryStream(file)) { // Use the memory stream in a binary reader. using (BinaryReader reader = new BinaryReader(memory)) { // Read in each byte from memory. for (int i = 0; i < file.Length; i++) { byte result = reader.ReadByte(); Console.WriteLine(result); } } } } } Output 137 80 78 71 13 10 26 10 0 0 0 13 73 72...

Discussion. It sometimes helps to put data into memory and simply leave it there. Memory is much faster than disk or network accesses. With MemoryStream, we can act upon the byte array stored in memory rather than a file or other resource.

Note: This consolidates resource acquisitions. It also gives you the ability to reliably use multiple streams on a single piece of data.

Locality of Reference

Also, you can sometimes reuse a single MemoryStream. Store the MemoryStream instance as a field. Then call the SetLength(0) method on the MemoryStream instance to reset it. This will reduce allocations during the algorithm.

Summary. MemoryStream allows you to use in-memory byte arrays or other data as though they are streams. Instead of storing data in files, you can store data in-memory for additional performance and control over the behavior of your program.