Επεξεργασία

Κοινή χρήση μέσω

MemoryStream.Capacity Property

  • Reference

Definition

Namespace:
System.IO
Assembly:
System.IO.dll
Assembly:
System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Source:
MemoryStream.cs
Source:
MemoryStream.cs
Source:
MemoryStream.cs

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

public:
 virtual property int Capacity { int get(); void set(int value); };
public virtual int Capacity { get; set; }
member this.Capacity : int with get, set
Public Overridable Property Capacity As Integer

Property Value

Int32

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

Exceptions

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.

Examples

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

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

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

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.

Applies to

See also