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

Int32

CollectionBase 可包含的元素数。

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

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

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

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

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

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