TableCellCollection.Capacity 属性

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

获取或设置为此集合预先分配的集合项容量。

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

为此集合预先分配的集合项容量。默认值为 8。

当尝试将 Capacity 设置为小于 Count 的当前值的值时引发。

该 Capacity 属性表示用于在此集合中存储项的预分配槽数，而 Count 该属性表示当前集合中当前项的实际数目。的值 Capacity 始终至少与值 Count一样大。

当新添加的集合项导致集合计数超过收集容量时，会自动增加容量以适应新添加的集合项。增加收集容量涉及到分配额外的收集槽，这会产生性能和内存开销。如果 Capacity 提前知道集合项总数或最大数目，请使用该属性来优化收集容量。使用此方法 TrimToSize 使集合容量与当前集合计数相等。