共用方式為


CollectionBase.Capacity 屬性

定義

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

public:
 property int Capacity { int get(); void set(int value); };
public int Capacity { get; set; }
[System.Runtime.InteropServices.ComVisible(false)]
public int Capacity { get; set; }
member this.Capacity : int with get, set
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.Capacity : int with get, set
Public Property Capacity As Integer

屬性值

CollectionBase 可包含的項目數。

屬性

例外狀況

Capacity 是設定為小於 Count 的值。

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

備註

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

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

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

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

適用於

另請參閱