Dictionary<TKey,TValue>.EnsureCapacity(Int32) Metoda

Definice

Obor názvů:

System.Collections.Generic

Sestavení:

netstandard.dll, System.Collections.dll

Zdroj:

Dictionary.cs

Zajišťuje, že slovník může obsahovat až zadaný počet položek bez dalšího rozšíření jeho záložního úložiště.

public:
 int EnsureCapacity(int capacity);

public int EnsureCapacity(int capacity);

member this.EnsureCapacity : int -> int

Public Function EnsureCapacity (capacity As Integer) As Integer

Parametry

capacity

Int32

Počet položek.

Návraty

Int32

Aktuální kapacita Dictionary<TKey,TValue>.

Výjimky

ArgumentOutOfRangeException

capacity je menší než 0.

Poznámky

Upozornění

Pokud capacity pochází ze vstupu uživatele, raději nechte kolekci změnit velikost samotné, protože prvky jsou přidány místo volání této metody. Pokud musíte použít uživatelem zadanou hodnotu, buď ji uchytejte na rozumný limit (například) nebo ověřte, Math.Clamp(untrustedValue, 0, 20)že počet prvků odpovídá zadané hodnotě.