CollectionBase.Capacity Vlastnost

Definice

Obor názvů:

System.Collections

Sestavení:

netstandard.dll, System.Collections.NonGeneric.dll

Zdroj:

CollectionBase.cs

Získá nebo nastaví počet prvků, které CollectionBase může obsahovat.

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

Počet prvků, které CollectionBase může obsahovat.

Výjimky

ArgumentOutOfRangeException

Capacity je nastavena na hodnotu, která je menší než Count.

OutOfMemoryException

V systému není k dispozici dostatek paměti.

Poznámky

Capacity je počet prvků, které CollectionBase lze uložit. Count je počet prvků, které jsou ve skutečnosti v CollectionBase.

Capacity je vždy větší než nebo rovno Count. Pokud Count při přidávání prvků překročíte Capacity , kapacita se automaticky zvýší 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 nastavením Capacity vlastnosti explicitně. Pokud je hodnota Capacity nastavena explicitně, interní pole je také relokováno 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.

Viz také

• Count