英語で読む

次の方法で共有


CollectionBase.Capacity プロパティ

定義

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

public int Capacity { get; set; }
[System.Runtime.InteropServices.ComVisible(false)]
public int Capacity { get; set; }

プロパティ値

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

属性

例外

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

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

注釈

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

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

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

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

適用対象

製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0

こちらもご覧ください