TableRowGroupCollection.Capacity プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
このコレクションの事前に割り当てられたコレクション項目の容量を取得または設定します。
public:
property int Capacity { int get(); void set(int value); };public int Capacity { get; set; }member this.Capacity : int with get, setPublic Property Capacity As Integerプロパティ値
このコレクションの、事前に割り当てられたコレクション項目の容量。 既定値は 8 です。
例外
注釈
このプロパティは Capacity 、このコレクションに項目を格納するために事前に割り当てられたスロットの数を表します。一方 Count 、プロパティはコレクション内の現在の項目の実際の数を表します。 の Capacity 値は常に、少なくとも Count.
新しく追加されたコレクション項目によってコレクション数がコレクション容量を超えると、新しく追加されたコレクション項目に対応するように容量が自動的に増加します。 コレクション容量を増やすには、追加のコレクション スロットを割り当てる必要があり、パフォーマンスとメモリのオーバーヘッドの両方が発生します。 コレクション項目の Capacity 合計数または最大数が事前にわかっている場合に、このプロパティを使用してコレクション容量を最適化します。 このメソッドを TrimToSize 使用して、コレクションの容量を現在のコレクション数と等しくします。