TableCellCollection.Capacity TableCellCollection.Capacity TableCellCollection.Capacity TableCellCollection.Capacity Property

Определение

Возвращает или задает предварительно выделенной емкости элементов коллекции для данной коллекции.Gets or sets the preallocated collection item capacity for this collection.

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

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

Предварительно выделенная емкость элементов коллекции для данной коллекции.The preallocated collection item capacity for this collection. Значение по умолчанию — 8.The default value is 8.

Исключения

Вызывается, когда выполняется попытка установить Capacity на значение, которое меньше текущего значения Count.Raised when an attempt is made to set Capacity to a value that is less than the current value of Count.

Комментарии

Свойство представляет число предварительно выделенных слотов для хранения элементов в этой коллекции, в Count то время как свойство представляет фактическое число элементов, находящихся в данный момент в коллекции. CapacityThe Capacity property represents the number of preallocated slots for storing items in this collection, whereas the Count property represents the actual number of items currently in the collection. Значение Capacity всегда имеет размер не меньше, чем Countзначение.The value of Capacity is always at least as large as the value of Count.

Когда добавленные элементы коллекции приводят к превышению емкости коллекции для счетчика коллекции, емкость увеличивается автоматически для размещения вновь добавленных элементов коллекции.When newly added collection items cause the collection count to exceed the collection capacity, the capacity is increased automatically to accommodate the newly added collection items. Увеличение емкости коллекции включает в себя выделение дополнительных слотов коллекций, что влечет за собой и производительность, и нагрузку на память.Increasing the collection capacity involves allocating additional collection slots, which incurs both performance and memory overhead. Capacity Используйте свойство, чтобы оптимизировать емкость коллекции в случаях, когда общее или максимальное число элементов коллекции известно заранее.Use the Capacity property to optimize the collection capacity in cases where the total or maximum number of collection items is known in advance. TrimToSize Используйте метод, чтобы заставить емкость коллекции на эквалайзер с текущим числом коллекций.Use the TrimToSize method to cause the collection capacity to equalize with the current collection count.

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