CollectionBase.Capacity 属性

定义

命名空间:

System.Collections

程序集:

System.Collections.NonGeneric.dll

Source:

CollectionBase.cs

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

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

public int Capacity { get; set; }

member this.Capacity : int with get, set

Public Property Capacity As Integer

属性值

Int32

CollectionBase 可包含的元素数。

例外

ArgumentOutOfRangeException

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

OutOfMemoryException

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

注解

Capacity 是 可以存储的元素 CollectionBase 数。 Count 是 中实际 CollectionBase包含的元素数。

Capacity 始终大于或等于 Count。 如果在 Count 添加元素时超出 Capacity ，则通过在复制旧元素和添加新元素之前重新分配内部数组来自动增加容量。

可以通过显式设置 Capacity 属性来减小容量。 显式设置 的值 Capacity 时，也会重新分配内部数组以适应指定的容量。

检索此属性的值是一个 O(1) 操作;设置属性是一个 O(n) 操作，其中 n 是新容量。

另请参阅

• Count