Partager via


Queue<T>.TrimExcess Méthode

Définition

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(Int32)

Définit la capacité d’un objet Queue<T> sur le nombre spécifié d’entrées.

TrimExcess()

Source:
Queue.cs
Source:
Queue.cs
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

S’applique à

TrimExcess(Int32)

Source:
Queue.cs

Définit la capacité d’un objet Queue<T> sur le nombre spécifié d’entrées.

public:
 void TrimExcess(int capacity);
public void TrimExcess (int capacity);
member this.TrimExcess : int -> unit
Public Sub TrimExcess (capacity As Integer)

Paramètres

capacity
Int32

Nouvelle capacité.

Exceptions

La capacité passée est inférieure au nombre d’entrées.

S’applique à