次の方法で共有


CollectionBase.Capacity プロパティ

定義

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

プロパティ値

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

属性

例外

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

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

注釈

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

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

プロパティを明示的に設定することで、容量を Capacity 減らすことができます。 の Capacity 値が明示的に設定されている場合、内部配列も、指定された容量に合わせて再割り当てされます。

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

適用対象

こちらもご覧ください