TableCellCollection.Capacity プロパティ

定義

このコレクションの事前に割り当てられたコレクション項目の容量を取得または設定します。Gets or sets the preallocated collection item capacity for this collection.

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

このコレクションの、事前に割り当てられたコレクション項目の容量。The preallocated collection item capacity for this collection. 既定値は 8 です。The default value is 8.

例外

CapacityCount の現在の値よりも小さい値に設定しようとしたときに発生します。Raised when an attempt is made to set Capacity to a value that is less than the current value of Count.

注釈

プロパティは、 Capacity このコレクションに項目を格納するための事前割り当て済みスロットの数を表します。一方、プロパティは、 Count 現在コレクション内にある項目の実際の数を表します。The Capacity property represents the number of preallocated slots for storing items in this collection, whereas the Count property represents the actual number of items currently in the collection. の値 Capacity は、常にの値と同じ大きさに Count なります。The value of Capacity is always at least as large as the value of Count.

新しく追加されたコレクションアイテムがコレクションの容量を超えると、新しく追加されたコレクションアイテムに合わせて容量が自動的に増加します。When newly added collection items cause the collection count to exceed the collection capacity, the capacity is increased automatically to accommodate the newly added collection items. 収集容量を増やすには、追加のコレクションスロットを割り当てる必要があります。これにより、パフォーマンスとメモリの両方のオーバーヘッドが発生します。Increasing the collection capacity involves allocating additional collection slots, which incurs both performance and memory overhead. Capacityコレクションアイテムの合計数または最大数が事前にわかっている場合は、プロパティを使用してコレクション容量を最適化します。Use the Capacity property to optimize the collection capacity in cases where the total or maximum number of collection items is known in advance. メソッドを使用して、 TrimToSize コレクションの容量が現在のコレクション数とイコライズされるようにします。Use the TrimToSize method to cause the collection capacity to equalize with the current collection count.

適用対象