Sdílet prostřednictvím


TableRowGroupCollection.Capacity Vlastnost

Definice

Získá nebo nastaví předem přidělenou kapacitu položky kolekce pro tuto kolekci.

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

Hodnota vlastnosti

Int32

Předem přidělená kapacita položky kolekce pro tuto kolekci. Výchozí hodnota je 8.

Výjimky

Vyvolá se při pokusu o nastavení Capacity hodnoty, která je menší než aktuální hodnota .Count

Poznámky

Vlastnost Capacity představuje počet předem přidělených slotů pro ukládání položek v této kolekci, zatímco Count vlastnost představuje skutečný počet položek aktuálně v kolekci. Hodnota Capacity je vždy alespoň tak velká jako hodnota .Count

Když nově přidané položky kolekce způsobí, že počet kolekcí překročí kapacitu kolekce, kapacita se automaticky zvýší tak, aby vyhovovala nově přidaných položek kolekce. Zvýšení kapacity kolekce zahrnuje přidělování dalších slotů kolekce, což způsobuje režii výkonu i paměti. Capacity Pomocí vlastnosti optimalizujte kapacitu kolekce v případech, kdy je předem znám celkový nebo maximální počet položek kolekce. Použijte metodu TrimToSize k tomu, aby se kapacita kolekce rovnala aktuálnímu počtu kolekcí.

Platí pro

Viz také