SortedList.Capacity Vlastnost

Definice

Obor názvů:

System.Collections

Sestavení:

System.Collections.NonGeneric.dll

Zdroj:

SortedList.cs

Získá nebo nastaví kapacitu objektu SortedList .

public:
 virtual property int Capacity { int get(); void set(int value); };

public virtual int Capacity { get; set; }

member this.Capacity : int with get, set

Public Overridable Property Capacity As Integer

Hodnota vlastnosti

Int32

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

Výjimky

ArgumentOutOfRangeException

Přiřazená hodnota je menší než aktuální počet prvků v objektu SortedList .

OutOfMemoryException

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

Poznámky

Capacity je počet prvků, které SortedList objekt může uložit. Count je počet prvků, které jsou ve skutečnosti v SortedList.

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 voláním TrimToSize nebo 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.

Viz také

• TrimToSize()