CollectionBase.Capacity 屬性

定義

命名空間:

System.Collections

組件:

System.Collections.NonGeneric.dll

來源:

CollectionBase.cs

取得或設定 CollectionBase 可包含的項目數目。

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

CollectionBase 可包含的項目數。

例外狀況

ArgumentOutOfRangeException

Capacity 是設定為小於 Count 的值。

OutOfMemoryException

系統上沒有足夠的記憶體可用。

備註

Capacity 是可以儲存的項目 CollectionBase 數目。 Count 是實際在中的 CollectionBase項目數目。

Capacity 一律大於或等於 Count。 如果 Count 新增元素時超過 Capacity ，則會先重新配置內部數位，再複製舊元素並新增新元素，以自動增加容量。

您可以藉由明確設定 Capacity 屬性來減少容量。 明確設定的值 Capacity 時，也會重新配置內部數位以容納指定的容量。

擷取這個屬性的值是 O(1) 作業;設定 屬性是 O(n) 作業，其中 n 是新的容量。

另請參閱

• Count