CollectionBase.Capacity 屬性
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得或設定 CollectionBase 可包含的項目數目。
public:
property int Capacity { int get(); void set(int value); };C#
public int Capacity { get; set; }C#
[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, setPublic Property Capacity As IntegerCollectionBase 可包含的項目數。
- 屬性
系統上沒有足夠的記憶體可用。
Capacity 是可以儲存的項目 CollectionBase 數目。 Count 是實際在中的 CollectionBase項目數目。
Capacity 一律大於或等於 Count。 如果 Count 新增元素時超過 Capacity ，則會先重新配置內部數位，再複製舊元素並新增新元素，以自動增加容量。
您可以藉由明確設定 Capacity 屬性來減少容量。 明確設定的值 Capacity 時，也會重新配置內部數位以容納指定的容量。
擷取這個屬性的值是 O(1) 作業;設定 屬性是 O(n) 作業，其中 n 是新的容量。
| 產品 | 版本 |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
| UWP | 10.0 |
