MemoryStream.Capacity Свойство

Определение

Пространство имен:

System.IO

Сборка:

System.Runtime.dll

Исходный код:

MemoryStream.cs

Возвращает или задает число байтов, выделенных для этого потока.

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

Значение свойства

Int32

Длина применимой к использованию части буфера для потока.

Исключения

ArgumentOutOfRangeException

Заданная емкость отрицательная или меньше текущей длины потока.

ObjectDisposedException

Текущий поток закрыт.

NotSupportedException

set вызывается для потока, емкость которого нельзя изменить.

Примеры

Этот пример входит в состав более крупного примера использования класса MemoryStream.

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

Комментарии

Capacity — это длина буфера для системных массивов байтов. Capacity не может быть задано значение меньше текущей длины потока.

См. также раздел

• Файловый и потоковый ввод-вывод
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл