共用方式為


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使用 方法可讓集合容量與目前的集合計數相等。

適用於

另請參閱