SortedList<TKey,TValue>.TrimExcess Methode

Definition

Legt die Kapazität auf die Anzahl der tatsächlich im SortedList<TKey,TValue> befindlichen Elemente fest, sofern diese Anzahl unter 90 Prozent der aktuellen Kapazität liegt.Sets the capacity to the actual number of elements in the SortedList<TKey,TValue>, if that number is less than 90 percent of current capacity.

public:
 void TrimExcess();
public void TrimExcess ();
member this.TrimExcess : unit -> unit
Public Sub TrimExcess ()

Hinweise

Diese Methode kann verwendet werden, um den Arbeitsspeicher Aufwand einer Sammlung zu minimieren, wenn der Auflistung keine neuen Elemente hinzugefügt werden.This method can be used to minimize a collection's memory overhead if no new elements will be added to the collection. Die Kosten für das erneute zuordnen und Kopieren eines großen SortedList<TKey,TValue> kann jedoch beträchtlich sein, sodass die- TrimExcess Methode nichts bewirkt, wenn die Liste mehr als 90 Prozent der Kapazität hat.The cost of reallocating and copying a large SortedList<TKey,TValue> can be considerable, however, so the TrimExcess method does nothing if the list is at more than 90 percent of capacity. Dadurch wird vermieden, dass für einen relativ kleinen Gewinn keine großen Kosten für die erneute Zuordnung anfallen.This avoids incurring a large reallocation cost for a relatively small gain.

Diese Methode ist ein O ( n )-Vorgang, bei dem gleich n ist Count .This method is an O(n) operation, where n is Count.

Um einen SortedList<TKey,TValue> auf seinen ursprünglichen Zustand zurückzusetzen, rufen Sie die-Methode auf, bevor Sie die Clear TrimExcess Methode aufrufen.To reset a SortedList<TKey,TValue> to its initial state, call the Clear method before calling TrimExcess method. Durch Kürzen eines leeren wird SortedList<TKey,TValue> die Kapazität von SortedList<TKey,TValue> auf die Standardkapazität festgelegt.Trimming an empty SortedList<TKey,TValue> sets the capacity of the SortedList<TKey,TValue> to the default capacity.

Die Kapazität kann auch mit der-Eigenschaft festgelegt werden Capacity .The capacity can also be set using the Capacity property.

Gilt für:

Weitere Informationen