CollectionBase.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 le nombre d'éléments que CollectionBase peut contenir.
public:
property int Capacity { int get(); void set(int value); };public int Capacity { get; set; }[System.Runtime.InteropServices.ComVisible(false)]
public int Capacity { get; set; }member this.Capacity : int with get, set[<System.Runtime.InteropServices.ComVisible(false)>]
member this.Capacity : int with get, setPublic Property Capacity As IntegerValeur de propriété
Nombre initial d'éléments que CollectionBase peut contenir.
- Attributs
Exceptions
Il n’y a pas assez de mémoire disponible sur le système.
Remarques
Capacity est le nombre d’éléments que peut CollectionBase stocker. Count est le nombre d’éléments qui se trouvent réellement dans le CollectionBase.
Capacity est toujours supérieur ou égal à Count. Si Count elle dépasse lors de Capacity l’ajout d’éléments, la capacité est automatiquement augmentée en réaffectant le tableau interne avant de copier les anciens éléments et d’ajouter les nouveaux éléments.
La capacité peut être réduite en définissant la Capacity propriété explicitement. Lorsque la valeur de Capacity est définie explicitement, le tableau interne est également réaffecté pour prendre en charge la capacité spécifiée.
La récupération de la valeur de cette propriété est une O(1) opération ; la définition de la propriété est une O(n) opération, où n est la nouvelle capacité.
