Queue<T>.TrimExcess Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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 n
Countist.
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.