MemoryStream Class

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Creates a stream whose backing store is memory.

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

public class MemoryStream : Stream

The MemoryStream type exposes the following members.

  NameDescription
Public methodMemoryStream()()()()Initializes a new instance of the MemoryStream class with an expandable capacity initialized to zero.
Public methodMemoryStream(array<Byte>[]()[][])Initializes a new non-resizable instance of the MemoryStream class based on the specified byte array.
Top

  NameDescription
Public propertyCanReadGets a value indicating whether the current stream supports reading. (Overrides Stream..::..CanRead.)
Public propertyCanSeekGets a value indicating whether the current stream supports seeking. (Overrides Stream..::..CanSeek.)
Public propertyCanTimeoutGets a value that determines whether the current stream can time out. (Inherited from Stream.)
Public propertyCanWriteGets a value indicating whether the current stream supports writing. (Overrides Stream..::..CanWrite.)
Public propertyLengthGets the length of the stream in bytes. (Overrides Stream..::..Length.)
Public propertyPositionGets or sets the current position within the stream. (Overrides Stream..::..Position.)
Public propertyReadTimeoutGets or sets a value, in milliseconds, that determines how long the stream will attempt to read before timing out. (Inherited from Stream.)
Public propertyWriteTimeoutGets or sets a value, in miliseconds, that determines how long the stream will attempt to write before timing out. (Inherited from Stream.)
Top

  NameDescription
Public methodCloseCloses the current stream and releases any resources (such as sockets and file handles) associated with the current stream. Instead of calling this method, ensure that the stream is properly disposed. (Inherited from Stream.)
Public methodDispose()()()()Releases all resources used by the Stream. (Inherited from Stream.)
Protected methodDispose(Boolean)Releases the unmanaged resources used by the MemoryStream class and optionally releases the managed resources. (Overrides Stream..::..Dispose(Boolean).)
Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodFinalizeCleans up resources. (Inherited from Stream.)
Public methodFlushOverrides the Stream..::..Flush method so that no action is performed. (Overrides Stream..::..Flush()()()().)
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodReadReads a block of bytes from the current stream and writes the data to a buffer. (Overrides Stream..::..Read(array<Byte>[]()[][], Int32, Int32).)
Public methodReadByteReads a byte from the current stream. (Overrides Stream..::..ReadByte()()()().)
Public methodSeekSets the position within the current stream to the specified value. (Overrides Stream..::..Seek(Int64, SeekOrigin).)
Public methodSetLengthSets the length of the current stream to the specified value. (Overrides Stream..::..SetLength(Int64).)
Public methodToArrayWrites the stream contents to a byte array, regardless of the Position property.
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Public methodWriteWrites a block of bytes to the current stream using data read from a buffer. (Overrides Stream..::..Write(array<Byte>[]()[][], Int32, Int32).)
Public methodWriteByteWrites a byte to the current stream at the current position. (Overrides Stream..::..WriteByte(Byte).)
Public methodWriteToWrites the entire contents of this memory stream to another stream.
Top

The current position of a stream is the position at which the next read or write operation could take place. The current position can be retrieved or set through the Seek method. When a new instance of MemoryStream is created, the current position is set to zero.

Memory streams created with an unsigned byte array provide a non-resizable stream of the data. When using a byte array, you can neither append to nor shrink the stream, although you might be able to modify the existing contents depending on the parameters passed into the constructor. Empty memory streams are resizable, and can be written to and read from.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show: