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, setPublic Property Capacity As IntegerЗначение свойства
Количество элементов, которые CollectionBase могут содержаться.
- Атрибуты
Исключения
В системе недостаточно памяти.
Комментарии
Capacity — это количество элементов, которые CollectionBase могут храниться. Count — это количество элементов, которые фактически находятся в элементе CollectionBase.
Capacity всегда больше или равно Count. При Count превышении Capacity при добавлении элементов емкость автоматически увеличивается путем перераспределения внутреннего массива перед копированием старых элементов и добавлением новых элементов.
Емкость можно уменьшить, задав Capacity свойство явным образом. Если значение задано явным образом, внутренний Capacity массив также перераспределен для размещения указанной емкости.
Получение значения этого свойства является операцией; задание свойства — O(1) это O(n) операция, где n находится новая емкость.
