Partager via


TableCellCollection.Capacity Propriété

Définition

Obtient ou paramètre la capacité d'éléments de collection préallouée pour cette collection.

public:
 property int Capacity { int get(); void set(int value); };
public int Capacity { get; set; }
member this.Capacity : int with get, set
Public Property Capacity As Integer

Valeur de propriété

Int32

La capacité d'élément de collection préallouée pour cette collection. La valeur par défaut est 8.

Exceptions

Levée lorsqu'une tentative de définition de Capacity sur une valeur inférieure à la valeur actuelle de Count est effectuée.

Remarques

La Capacity propriété représente le nombre d’emplacements prélocalisés pour le stockage d’éléments dans cette collection, tandis que la Count propriété représente le nombre réel d’éléments actuellement présents dans la collection. La valeur de l’objet Capacity est toujours au moins aussi importante que la valeur de Count.

Lorsque les éléments de collection nouvellement ajoutés entraînent le dépassement de la capacité de collecte, la capacité est augmentée automatiquement pour prendre en charge les éléments de collection nouvellement ajoutés. L’augmentation de la capacité de collecte implique l’allocation d’emplacements de collection supplémentaires, ce qui entraîne des surcharges de performances et de mémoire. Utilisez la Capacity propriété pour optimiser la capacité de collecte dans les cas où le nombre total ou maximal d’éléments de collection est connu à l’avance. Utilisez la TrimToSize méthode pour que la capacité de collection soit égale au nombre de regroupements actuel.

S’applique à