Queue<T>.TrimExcess Méthode

Définition

Définit la capacité au nombre réel d'éléments dans Queue<T>, si ce nombre est inférieur à 90 pour cent de capacité actuelle.Sets the capacity to the actual number of elements in the Queue<T>, 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 ()

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.This method can be used to minimize a collection's memory overhead if no new elements will be added to the collection. Toutefois, le coût de réallocation et de Queue<T> copie d’une grande taille peut être considérable TrimExcess . par conséquent, la méthode ne fait rien si la liste est supérieure à 90% de la capacité.The cost of reallocating and copying a large Queue<T> can be considerable, however, so the TrimExcess method does nothing if the list is at more than 90 percent of capacity. Cela évite un coût de réallocation important pour un gain relativement faible.This avoids incurring a large reallocation cost for a relatively small gain.

Cette méthode est une opération On(), où n est Count.This method is an O(n) operation, where n is Count.

Pour réinitialiser un Queue<T> à son état initial, appelez la Clear méthode avant d' TrimExcess appeler la méthode.To reset a Queue<T> to its initial state, call the Clear method before calling TrimExcess method. Le découpage d’une valeur Queue<T> vide Queue<T> définit la capacité du sur la capacité par défaut.Trimming an empty Queue<T> sets the capacity of the Queue<T> to the default capacity.

S’applique à

Voir aussi