Export (0) Print
Expand All

MemoryStream.Capacity Property

Gets or sets the number of bytes allocated for this stream.

Namespace:  System.IO
Assemblies:   mscorlib (in mscorlib.dll)
  System.IO (in System.IO.dll)

public virtual int Capacity { get; set; }

Property Value

Type: System.Int32
The length of the usable portion of the buffer for the stream.

ExceptionCondition
ArgumentOutOfRangeException

A capacity is set that is negative or less than the current length of the stream.

ObjectDisposedException

The current stream is closed.

NotSupportedException

set is invoked on a stream whose capacity cannot be modified.

Capacity is the buffer length for system-provided byte arrays. Capacity cannot be set to a value less than the current length of the stream.

This code example is part of a larger example provided for the MemoryStream class.

// Write the stream properties to the console.
Console.WriteLine(
    "Capacity = {0}, Length = {1}, Position = {2}\n",
    memStream.Capacity.ToString(),
    memStream.Length.ToString(),
    memStream.Position.ToString());

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Show:
© 2015 Microsoft