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