Поделиться через


CollectionBase.Capacity Свойство

Определение

Возвращает или задает число элементов, которое может содержать список CollectionBase.

public:
 property int Capacity { int get(); void set(int value); };
public int Capacity { get; set; }
[System.Runtime.InteropServices.ComVisible(false)]
public int Capacity { get; set; }
member this.Capacity : int with get, set
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.Capacity : int with get, set
Public Property Capacity As Integer

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

Количество элементов, которое может содержать коллекция CollectionBase.

Атрибуты

Исключения

Для Capacity установлено значение, которое меньше Count.

Не хватает памяти в системе.

Комментарии

Capacity — это количество элементов, которые может хранить объект CollectionBase . Count — это количество элементов, которые фактически находятся в CollectionBase.

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

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

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

Применяется к

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