使用英语阅读

通过


CollectionBase.Capacity 属性

定义

获取或设置 CollectionBase 可包含的元素数。

public int Capacity { get; set; }
[System.Runtime.InteropServices.ComVisible(false)]
public int Capacity { get; set; }

属性值

CollectionBase 可包含的元素数。

属性

例外

Capacity 已设置为一个小于 Count 的值。

系统上没有足够的可用内存。

注解

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

另请参阅