ArrayList.Capacity Свойство

Определение

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

System.Collections

Сборки:

netstandard.dll, System.Runtime.dll

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

ArrayList.cs

Возвращает или задает количество элементов, которые ArrayList могут содержаться.

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

Количество элементов, которые ArrayList могут содержаться.

Исключения

ArgumentOutOfRangeException

Capacity имеет значение, меньшее Count.

OutOfMemoryException

В системе недостаточно памяти.

Комментарии

Capacity — это количество элементов, которые ArrayList могут храниться. Count — это количество элементов, которые фактически находятся в элементе ArrayList.

Capacity всегда больше или равно Count. При Count превышении Capacity при добавлении элементов емкость автоматически увеличивается путем перераспределения внутреннего массива перед копированием старых элементов и добавлением новых элементов.

Емкость можно уменьшить путем вызова TrimToSize или явного Capacity задания свойства. Если значение задано явным образом, внутренний Capacity массив также перераспределен для размещения указанной емкости.

Получение значения этого свойства является операцией; задание свойства — O(1) это O(n) операция, где n находится новая емкость.

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

• Count