Capacity Property
Collapse the table of content
Expand the table of content

MemoryStream.Capacity Property

 

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

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

Public Overridable Property Capacity As Integer

Property Value

Type: System.Int32

The length of the usable portion of the buffer for the stream.

Exception Condition
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}", _
    memStream.Capacity.ToString(), _
    memStream.Length.ToString(), _
    memStream.Position.ToString())

Universal Windows Platform
Available since 4.5
.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
Return to top
Show:
© 2016 Microsoft