Partager via


Stack<T>.TrimExcess Méthode

Définition

Surcharges

TrimExcess()

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

TrimExcess(Int32)

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

TrimExcess()

Source:
Stack.cs
Source:
Stack.cs
Source:
Stack.cs

Définit la capacité sur le nombre réel d’éléments dans le Stack<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 Stack<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 Stack<T> à son état initial, appelez la méthode Clear avant d’appeler TrimExcess méthode. Le découpage d’une Stack<T> vide définit la capacité du Stack<T> sur la capacité par défaut.

Voir aussi

S’applique à

TrimExcess(Int32)

Source:
Stack.cs

Définit la capacité d’un objet Stack<T> sur un 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 à 0 ou nombre d’entrées.

S’applique à