ArrayList.Capacity 屬性

定義

命名空間:

System.Collections

組件:

System.Runtime.dll

來源:

ArrayList.cs

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

public:
 virtual property int Capacity { int get(); void set(int value); };

public virtual int Capacity { get; set; }

member this.Capacity : int with get, set

Public Overridable Property Capacity As Integer

屬性值

Int32

ArrayList 可包含的項目數。

例外狀況

ArgumentOutOfRangeException

Capacity 是設定為小於 Count 的值。

OutOfMemoryException

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

備註

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

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

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

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

另請參閱

• Count