TableRowGroupCollection.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

Int32

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

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

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

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