MemoryStream::Capacity Property

.NET Framework (current version)

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

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

Syntax

public:
property int Capacity {
	virtual int get();
	virtual void set(int value);
}

Property Value

Type: System::Int32

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

Exceptions

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.

Remarks

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.

Examples

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

C++

// 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() );

Universal Windows Platform
Available since 8
.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