Queue<T>.TrimExcess Metoda

  • Reference

Definice

Obor názvů:
System.Collections.Generic
Sestavení:
System.Collections.dll
Sestavení:
System.dll
Sestavení:
netstandard.dll

Přetížení

TrimExcess()

Nastaví kapacitu na skutečný počet prvků v Queue<T>, pokud je toto číslo menší než 90 procent aktuální kapacity.
TrimExcess(Int32)

Nastaví kapacitu objektu Queue<T> na zadaný počet položek.

TrimExcess()

Zdroj:
Queue.cs
Zdroj:
Queue.cs
Zdroj:
Queue.cs

Nastaví kapacitu na skutečný počet prvků v Queue<T>, pokud je toto číslo 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řemístění a kopírování velkých Queue<T> však mohou být značné, takže metoda TrimExcess nic nedělá, pokud je seznam větší než 90 procent kapacity. Tím se zabrání vzniku velkých nákladů na relokaci za relativně malý zisk.

Tato metoda je operace O(n), kde n je Count.

Chcete-li obnovit Queue<T> do počátečního stavu, před voláním metody TrimExcess zavolejte metodu Clear. Oříznutí prázdné Queue<T> nastaví kapacitu Queue<T> na výchozí kapacitu.

Viz také

Platí pro

TrimExcess(Int32)

Zdroj:
Queue.cs

Nastaví kapacitu objektu Queue<T> na zadaný počet položek.

public:
 void TrimExcess(int capacity);
public void TrimExcess (int capacity);
member this.TrimExcess : int -> unit
Public Sub TrimExcess (capacity As Integer)

Parametry

capacity
Int32

Nová kapacita.

Výjimky

ArgumentOutOfRangeException

Předaná kapacita je nižší než počet položek.

Platí pro