SortedList<TKey,TValue>.TrimExcess Metoda
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í.
Nastaví kapacitu na skutečný počet prvků v , SortedList<TKey,TValue>pokud je tento počet menší než 90 procent aktuální kapacity.
public:
void TrimExcess();
public void TrimExcess ();
member this.TrimExcess : unit -> unit
Public Sub TrimExcess ()
Poznámky
Tuto metodu lze použít k minimalizaci režie paměti kolekce, pokud do kolekce nebudou přidány žádné nové prvky. Náklady na přerozdělení a kopírování velkého SortedList<TKey,TValue> objektu však mohou být značné, takže TrimExcess metoda neprovede nic, pokud je seznam na více než 90 % kapacity. Tím se vyhnete velkým nákladům na relokaci s relativně malým ziskem.
Tato metoda je operace O(n
), kde n
je Count.
Pokud chcete obnovit počáteční stav objektu SortedList<TKey,TValue> , zavolejte metodu Clear před voláním TrimExcess metody. Oříznutí prázdné SortedList<TKey,TValue> nastaví kapacitu objektu SortedList<TKey,TValue> na výchozí kapacitu.
Kapacitu lze také nastavit pomocí Capacity vlastnosti .