Queue<T>.TrimExcess Méthode

Définition

Espace de noms:

System.Collections.Generic

Assembly:

System.Collections.dll

Surcharges

TrimExcess()

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

TrimExcess()

Source:

Queue.cs

Définit la capacité au nombre réel d'éléments dans Queue<T>, 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 Queue<T> 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 Queue<T> état initial, appelez la Clear méthode avant d’appeler TrimExcess la méthode . La suppression d’un vide Queue<T> définit la capacité du sur Queue<T> la capacité par défaut.

Voir aussi

• Clear()
• Count