Stack<T>.TrimExcess Methode

Definition

Namespace:

System.Collections.Generic

Assemblys:

netstandard.dll, System.Collections.dll

Überlädt

Name	Beschreibung
TrimExcess()	Legt die Kapazität auf die tatsächliche Anzahl der Elemente in der Stack<T>, wenn diese Zahl kleiner als 90 % der aktuellen Kapazität ist.
TrimExcess(Int32)	Legt die Kapazität eines Stack<T> Objekts auf eine angegebene Anzahl von Einträgen fest.

TrimExcess()

Quelle:

Stack.cs

Legt die Kapazität auf die tatsächliche Anzahl der Elemente in der Stack<T>, wenn diese Zahl kleiner als 90 % der aktuellen Kapazität ist.

public:
 void TrimExcess();

public void TrimExcess();

member this.TrimExcess : unit -> unit

Public Sub TrimExcess ()

Hinweise

Diese Methode kann verwendet werden, um den Arbeitsspeicheraufwand einer Auflistung zu minimieren, wenn der Auflistung keine neuen Elemente hinzugefügt werden. Die Kosten für die Umverteilung und das Kopieren eines Großen Stack<T> können jedoch erheblich sein, so dass die TrimExcess Methode nichts tut, wenn die Liste mehr als 90 Prozent der Kapazität beträgt. Dies vermeidet eine große Umschichtungskosten für einen relativ kleinen Gewinn.

Bei dieser Methode handelt es sich um einen O()-Vorgang, wobei n es sich um einen O(n)-Vorgang handeltCount.

Rufen Sie die Methode vor dem Aufrufen der Methode auf, um den Stack<T>Clear Anfangszustand zurückzusetzen TrimExcess . Durch das Kürzen eines leeren Stack<T> Elements wird die Kapazität der Stack<T> Standardkapazität festgelegt.

Weitere Informationen

• Clear()
• Count

TrimExcess(Int32)

Quelle:

Stack.cs

Legt die Kapazität eines Stack<T> Objekts auf eine angegebene Anzahl von Einträgen fest.

public:
 void TrimExcess(int capacity);

public void TrimExcess(int capacity);

member this.TrimExcess : int -> unit

Public Sub TrimExcess (capacity As Integer)

Parameter

capacity

Int32

Die neue Kapazität.

Ausnahmen

ArgumentOutOfRangeException

Die übergebene Kapazität ist niedriger als 0 oder die Anzahl der Einträge.