ArrayList.Capacity 属性
获取或设置 ArrayList 可包含的元素数。
**命名空间:**System.Collections
**程序集:**mscorlib（在 mscorlib.dll 中）
语法
声明
Public Overridable Property Capacity As Integer
用法
Dim instance As ArrayList
Dim value As Integer
value = instance.Capacity
instance.Capacity = value
public virtual int Capacity { get; set; }
public:
virtual property int Capacity {
int get ();
void set (int value);
}
/** @property */
public int get_Capacity ()
/** @property */
public void set_Capacity (int value)
public function get Capacity () : int
public function set Capacity (value : int)
属性值
ArrayList 可包含的元素数。
异常
| 异常类型 | 条件 |
|---|---|
Capacity 设置为小于 Count 的值。 |
备注
Capacity 是 ArrayList 可以存储的元素数。Count 是 ArrayList 中实际存储的元素数。
Capacity 总是大于或等于 Count。如果在添加元素时 Count 超过 Capacity，则通过在复制旧元素和添加新元素之前重新分配内部数组来使容量自动增加。
可通过调用 TrimToSize 或通过显式设置 Capacity 属性减少容量。如果 Capacity 的值显式设置，则内部数组也需要重新分配以容纳指定的容量。
检索此属性值的运算复杂度为 O(1)；设置此属性的运算复杂度为 O(n)，其中，n 是新容量。
平台
Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。
版本信息
.NET Framework
受以下版本支持：2.0、1.1、1.0
.NET Compact Framework
受以下版本支持：2.0、1.0