TableCellCollection.Capacity Vlastnost

Definice

Obor názvů:

System.Windows.Documents

Sestavení:

PresentationFramework.dll

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

ArgumentOutOfRangeException

Vyvolá se při pokusu nastavit Capacity hodnotu, 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žkám kolekce. Zvýšení kapacity kolekce zahrnuje přidělení dalších slotů kolekce, což způsobuje režii na výkon i paměť. Capacity Pomocí vlastnosti můžete optimalizovat kapacitu kolekce v případech, kdy je předem znám celkový nebo maximální počet položek kolekce. TrimToSize Metoda slouží k tomu, aby se kapacita kolekce rovnala aktuálnímu počtu kolekcí.