TableColumnCollection.Capacity Свойство

Определение

Пространство имен:

System.Windows.Documents

Сборка:

PresentationFramework.dll

Возвращает или задает предварительно выделенную емкость элемента коллекции для данной коллекции.

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.

Исключения

ArgumentOutOfRangeException

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

Комментарии

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

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

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

• Count