TableCellCollection.Capacity 屬性

定義

命名空間:

System.Windows.Documents

組件:

PresentationFramework.dll

取得或設定這個集合預先配置的集合項目容量。

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。

例外狀況

ArgumentOutOfRangeException

嘗試將 Capacity 的值設為小於 Count 的目前值時引發。

備註

屬性 Capacity 代表儲存在此集合中專案的預先配置位置數目，而 Count 屬性則代表目前在集合中的實際專案數目。 的值 Capacity 一律與 的值 Count 一樣大。

當新加入的收集項目導致集合計數超過收集容量時，會自動增加容量以容納新加入的收集項目。 增加收集容量牽涉到配置額外的收集位置，這會產生效能和記憶體額外負荷。 Capacity使用 屬性，在事先知道集合專案總數或最大值的情況下，將收集容量優化。 TrimToSize使用 方法可讓集合容量與目前的集合計數相等。