Queue<T>.TrimExcess Méthode

Définition

Espace de noms:

System.Collections.Generic

Assembly:

System.Collections.dll

Surcharges

TrimExcess()

Définit la capacité sur le nombre réel d’éléments dans le Queue<T>, si ce nombre est inférieur à 90 % de la capacité actuelle.

TrimExcess()

Source:

Queue.cs

Définit la capacité sur le nombre réel d’éléments dans le Queue<T>, si ce nombre est inférieur à 90 % 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 Queue<T> peut toutefois être considérable, de sorte que la méthode TrimExcess ne fait rien si la liste est à plus de 90 % de capacité. Cela évite d’entraîner un coût de réaffectation important pour un gain relativement faible.

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

Pour réinitialiser un Queue<T> à son état initial, appelez la méthode Clear avant d’appeler TrimExcess méthode. Le découpage d’une Queue<T> vide définit la capacité du Queue<T> sur la capacité par défaut.

Voir aussi

• Clear()
• Count