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

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

Int32

Предварительно выделенная емкость элементов коллекции для данной коллекции. Значение по умолчанию: 8.

Исключения

Вызывается, когда выполняется попытка установить Capacity на значение, которое меньше текущего значения Count.

Комментарии

Свойство Capacity представляет количество предварительнораспределенных слотов для хранения элементов в этой коллекции, тогда как Count свойство представляет фактическое количество элементов, в настоящее время в коллекции. Значение Capacity всегда равно значению Count.

Если только что добавленные элементы коллекции приводят к превышению емкости коллекции, емкость увеличивается автоматически, чтобы вместить только что добавленные элементы коллекции. Увеличение емкости коллекции включает выделение дополнительных слотов коллекции, что приводит к затратам на производительность и память. Capacity Используйте свойство для оптимизации емкости коллекции в тех случаях, когда общее или максимальное количество элементов коллекции известно заранее. TrimToSize Используйте метод, чтобы емкость коллекции была равна текущему количеству коллекций.

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