CollectionBase.Capacity 属性
本文内容
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置 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 是 可以存储的元素 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 |