CollectionBase.Capacity Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví počet prvků, které CollectionBase mohou obsahovat.
public:
property int Capacity { int get(); void set(int value); };public int Capacity { get; set; }[System.Runtime.InteropServices.ComVisible(false)]
public int Capacity { get; set; }member this.Capacity : int with get, set[<System.Runtime.InteropServices.ComVisible(false)>]
member this.Capacity : int with get, setPublic Property Capacity As IntegerHodnota vlastnosti
Počet prvků, které může obsahovat CollectionBase .
- Atributy
Výjimky
V systému není k dispozici dostatek paměti.
Poznámky
Capacity je počet prvků, které může uložit CollectionBase . Count je počet prvků, které jsou ve skutečnosti v CollectionBase.
Capacity je vždy větší než nebo rovno Count. Pokud Count se při přidávání prvků překročí Capacity , kapacita se automaticky zvýší opětovným přidělením interního pole před zkopírováním starých prvků a přidáním nových prvků.
Kapacitu lze snížit explicitním Capacity nastavením vlastnosti. Když je hodnota Capacity explicitně nastavena, interní pole je také znovu přiděleno tak, aby vyhovovalo zadané kapacitě.
Načtení hodnoty této vlastnosti je O(1) operace. Nastavení vlastnosti je O(n) operace, kde n je nová kapacita.
