Queue<T>.TrimExcess Metoda

Definicja

Przestrzeń nazw:

System.Collections.Generic

Zestaw:

System.Collections.dll

Przeciążenia

TrimExcess()

Ustawia pojemność na rzeczywistą liczbę elementów w Queue<T>, jeśli ta liczba jest mniejsza niż 90 procent bieżącej pojemności.

TrimExcess()

Źródło:

Queue.cs

Ustawia pojemność na rzeczywistą liczbę elementów w Queue<T>, jeśli ta liczba jest mniejsza niż 90 procent bieżącej pojemności.

public:
 void TrimExcess();

public void TrimExcess ();

member this.TrimExcess : unit -> unit

Public Sub TrimExcess ()

Uwagi

Tej metody można użyć do zminimalizowania obciążenia pamięci kolekcji, jeśli do kolekcji nie zostaną dodane żadne nowe elementy. Koszt reallokowania i kopiowania dużych Queue<T> może być jednak znaczny, więc metoda TrimExcess nic nie robi, jeśli lista jest na ponad 90 procent pojemności. Pozwala to uniknąć ponoszenia dużych kosztów reallokacji dla stosunkowo małego zysku.

Ta metoda jest operacją O(n), gdzie n jest Count.

Aby zresetować Queue<T> do stanu początkowego, przed wywołaniem metody TrimExcess wywołaj metodę Clear. Przycinanie pustej Queue<T> ustawia pojemność Queue<T> na pojemność domyślną.

Zobacz też

• Clear()
• Count