TableColumnCollection.Capacity プロパティ

定義

このコレクションの事前に割り当てられたコレクション項目の容量を取得または設定します。

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

プロパティ値

Int32

このコレクションの、事前に割り当てられたコレクション項目の容量。 既定値は 8 です。

例外

CapacityCount の現在の値よりも小さい値に設定しようとしたときに発生します。

注釈

このプロパティは Capacity 、このコレクションに項目を格納するために事前に割り当てられたスロットの数を表します。一方 Count 、プロパティはコレクション内の現在の項目の実際の数を表します。 の Capacity 値は常に、少なくとも Count.

新しく追加されたコレクション項目によってコレクション数がコレクション容量を超えると、新しく追加されたコレクション項目に対応するように容量が自動的に増加します。 コレクション容量を増やすには、追加のコレクション スロットを割り当てる必要があり、パフォーマンスとメモリのオーバーヘッドの両方が発生します。 コレクション項目の Capacity 合計数または最大数が事前にわかっている場合に、このプロパティを使用してコレクション容量を最適化します。 このメソッドを TrimToSize 使用して、コレクションの容量を現在のコレクション数と等しくします。

適用対象

こちらもご覧ください