SortedList<TKey,TValue>.Capacity Vlastnost

Definice

Obor názvů:

System.Collections.Generic

Sestavení:

System.Collections.dll

Zdroj:

SortedList.cs

Získá nebo nastaví počet prvků, které SortedList<TKey,TValue> mohou 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é SortedList<TKey,TValue> může obsahovat.

Výjimky

ArgumentOutOfRangeException

Capacity je nastavená 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é mohou být uloženy SortedList<TKey,TValue> . Count je počet prvků, které jsou ve skutečnosti v objektu SortedList<TKey,TValue>.

Capacityje vždy větší než nebo rovno .Count Pokud Count se Capacity při přidávání prvků překročí, kapacita se zvýší automatickým přerozdě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 TrimExcess nebo explicitním Capacity nastavením vlastnosti . Když je hodnota Capacity explicitně nastavena, interní pole se také znovu přidělí, aby vyhovovalo zadané kapacitě.

Načtení hodnoty této vlastnosti je O(1) operace; nastavením vlastnosti je operace O(n), kde n je nová kapacita.

Viz také

• Count
• TrimExcess()