Queue<T>.TrimExcess Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> unitPublic 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 -> unitPublic Sub TrimExcess (capacity As Integer)Paramètres
- capacity
- Int32
Nouvelle capacité.
Exceptions
La capacité passée est inférieure au nombre d’entrées.
