Teilen über


Queue<T>.TrimExcess Methode

Definition

Überlädt

TrimExcess()

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

TrimExcess(Int32)

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

TrimExcess()

Quelle:
Queue.cs
Quelle:
Queue.cs
Quelle:
Queue.cs

Legt die Kapazität auf die tatsächliche Anzahl der Elemente in der Queue<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 Queue<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 Queue<T> auf den Anfangszustand zurückzusetzen, rufen Sie die Clear-Methode auf, bevor Sie TrimExcess Methode aufrufen. Beim Kürzen einer leeren Queue<T> wird die Kapazität des Queue<T> auf die Standardkapazität festgelegt.

Weitere Informationen

Gilt für:

TrimExcess(Int32)

Quelle:
Queue.cs

Legt die Kapazität eines Queue<T> -Objekts auf die 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

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

Gilt für: