TableRowCollection.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

プロパティ値

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

例外

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

注釈

プロパティは Capacity 、このコレクションにアイテムを格納するために事前に割り当てられたスロットの数を表します。一方 Count 、 プロパティはコレクション内の現在のアイテムの実際の数を表します。 の Capacity 値は、常に の値 Countと同じ大きさです。

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

適用対象

こちらもご覧ください