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 elemencie 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 elemencie 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 przydziału i kopiowania dużego Queue<T> może być jednak znaczny, więc TrimExcess metoda nie robi nic, jeśli lista jest na ponad 90 procent pojemności. Pozwala to uniknąć ponoszenia dużych kosztów alokacji w przypadku stosunkowo małego zysku.

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

Aby zresetować Queue<T> obiekt do stanu początkowego, wywołaj metodę Clear przed wywołaniem TrimExcess metody . Przycinanie pustej Queue<T> wartości powoduje ustawienie pojemności Queue<T> domyślnej.

Zobacz też

• Clear()
• Count