Stack<T>.TrimExcess Methode

  • Referenz

Definition

Namespace:
System.Collections.Generic
Assembly:
System.Collections.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Überlädt

TrimExcess()

Legt die Kapazität auf die tatsächliche Anzahl der Elemente in der Stack<T>fest, 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
Quelle:
Stack.cs
Quelle:
Stack.cs

Legt die Kapazität auf die tatsächliche Anzahl der Elemente in der Stack<T>fest, 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 das Neuverlagern und Kopieren einer großen Stack<T> können jedoch erheblich sein, sodass die TrimExcess Methode nichts tut, wenn die Liste mehr als 90 Prozent der Kapazität hat. Dies vermeidet eine große Umschichtungskosten für einen relativ kleinen Gewinn.

Diese Methode ist ein O(n) Vorgang, bei dem nCountist.

Um einen Stack<T> auf den Anfangszustand zurückzusetzen, rufen Sie die Clear-Methode auf, bevor Sie TrimExcess Methode aufrufen. Beim Kürzen einer leeren Stack<T> wird die Kapazität des Stack<T> auf die Standardkapazität festgelegt.

Weitere Informationen

Gilt für:

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.

Gilt für: