Udostępnij za pośrednictwem

Stack<T>.TrimExcess Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Collections.Generic
Zestaw:
System.Collections.dll
Zestaw:
System.dll
Zestaw:
netstandard.dll

Przeciążenia

TrimExcess()

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

Ustawia pojemność obiektu Stack<T> na określoną liczbę wpisów.

TrimExcess()

Źródło:
Stack.cs
Źródło:
Stack.cs
Źródło:
Stack.cs

Ustawia pojemność na rzeczywistą liczbę elementów w Stack<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 Stack<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ć Stack<T> do stanu początkowego, przed wywołaniem metody TrimExcess wywołaj metodę Clear. Przycinanie pustej Stack<T> ustawia pojemność Stack<T> na pojemność domyślną.

Zobacz też

Dotyczy

TrimExcess(Int32)

Źródło:
Stack.cs

Ustawia pojemność obiektu Stack<T> na określoną liczbę wpisów.

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

Parametry

capacity
Int32

Nowa pojemność.

Wyjątki

ArgumentOutOfRangeException

Przekazana pojemność jest niższa niż 0 lub liczba wpisów.

Dotyczy