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