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 o nastavení Capacity na 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.

Pokud 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 výkonu i paměti. Capacity Pomocí vlastnosti optimalizujte kapacitu kolekce v případech, kdy je celkový nebo maximální počet položek kolekce znám předem. Použijte metodu TrimToSize k tomu, aby se kapacita kolekce rovnala aktuálnímu počtu kolekcí.