ArrayList.Capacity プロパティ

定義

ArrayList に格納できる要素の数を取得または設定します。

public:
 virtual property int Capacity { int get(); void set(int value); };
public virtual int Capacity { get; set; }
member this.Capacity : int with get, set
Public Overridable Property Capacity As Integer

プロパティ値

ArrayList に格納できる要素の数。

例外

CapacityCount より小さい値に設定されます。

システムで使用可能なメモリが不足しています。

注釈

Capacity は、 が格納できる要素 ArrayList の数です。 Count は、 に実際に含まれる要素の数です ArrayList

Capacity は常に 以上 Countです。 Count要素の追加中に をCapacity超えると、古い要素をコピーして新しい要素を追加する前に内部配列を再割り当てすることで、容量が自動的に増加します。

を呼び出 TrimToSize すか、 プロパティを明示的に設定することで、容量を Capacity 減らすことができます。 の Capacity 値が明示的に設定されている場合は、指定された容量に対応するように内部配列も再割り当てされます。

このプロパティの値の取得は操作です O(1) 。プロパティの設定は操作です O(n) 。ここで n 、 は新しい容量です。

適用対象

こちらもご覧ください