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 、は新しい容量です。