SortedList<TKey,TValue>.TrimExcess Méthode

Définition

Espace de noms:

System.Collections.Generic

Assembly:

System.Collections.dll

Source:

SortedList.cs

Définit la capacité au nombre réel d'éléments dans SortedList<TKey,TValue>, si ce nombre est inférieur à 90 pour cent de la capacité actuelle.

public:
 void TrimExcess();

public void TrimExcess ();

member this.TrimExcess : unit -> unit

Public Sub TrimExcess ()

Remarques

Cette méthode peut être utilisée pour réduire la surcharge de mémoire d’une collection si aucun nouvel élément n’est ajouté à la collection. Le coût de la réaffectation et de la copie d’une grande taille SortedList<TKey,TValue> peut toutefois être considérable, de sorte que la TrimExcess méthode ne fait rien si la liste est à plus de 90 pour cent de la capacité. Cela évite d’encourir un coût de réallocation important pour un gain relativement faible.

Cette méthode est une opération O(n), où n est Count.

Pour rétablir son SortedList<TKey,TValue> état initial, appelez la Clear méthode avant d’appeler TrimExcess la méthode . La suppression d’un vide SortedList<TKey,TValue> définit la capacité du sur SortedList<TKey,TValue> la capacité par défaut.

La capacité peut également être définie à l’aide de la Capacity propriété .

Voir aussi

• Clear()
• Capacity
• Count