TableColumnCollection.Capacity Propriété
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.
Obtient ou définit la capacité d’élément 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, setPublic Property Capacity As IntegerValeur de propriété
Capacité d’élément de collection pré-allouée pour cette collection. La valeur par défaut est 8.
Exceptions
Déclenché lorsqu’une tentative est effectuée pour définir Capacity une valeur inférieure à la valeur actuelle de Count.
Remarques
La Capacity propriété représente le nombre d’emplacements pré-alloué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 dans la collection. La valeur de 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 automatiquement augmentée 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 collecte supplémentaires, ce qui entraîne à la fois des performances et une surcharge 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 faire en sorte que la capacité de collection soit égalisée au nombre de regroupements actuel.
