TableCellCollection.Capacity Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает предварительно выделенной емкости элементов коллекции для данной коллекции.
public:
property int Capacity { int get(); void set(int value); };
public int Capacity { get; set; }
member this.Capacity : int with get, set
Public Property Capacity As Integer
Значение свойства
Предварительно выделенная емкость элементов коллекции для данной коллекции. Значение по умолчанию: 8.
Исключения
Вызывается, когда выполняется попытка установить Capacity на значение, которое меньше текущего значения Count.
Комментарии
Свойство Capacity представляет количество предварительнораспределенных слотов для хранения элементов в этой коллекции, тогда как Count свойство представляет фактическое количество элементов, в настоящее время в коллекции. Значение Capacity всегда равно значению Count.
Если только что добавленные элементы коллекции приводят к превышению емкости коллекции, емкость увеличивается автоматически, чтобы вместить только что добавленные элементы коллекции. Увеличение емкости коллекции включает выделение дополнительных слотов коллекции, что приводит к затратам на производительность и память. Capacity Используйте свойство для оптимизации емкости коллекции в тех случаях, когда общее или максимальное количество элементов коллекции известно заранее. TrimToSize Используйте метод, чтобы емкость коллекции была равна текущему количеству коллекций.