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

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

Int32

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

Атрибуты

Исключения

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

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

Комментарии

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

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

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

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

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

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