TableRowCollection.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 чтобы привести к выравниванию емкости коллекции с текущим числом коллекций.

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

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