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

属性值

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

例外

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

注解

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

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

适用于

另请参阅