Lire en anglais

Partager via


CollectionBase.Capacity Propriété

Définition

Obtient ou définit le nombre d'éléments que CollectionBase peut contenir.

public int Capacity { get; set; }
[System.Runtime.InteropServices.ComVisible(false)]
public int Capacity { get; set; }

Valeur de propriété

Nombre initial d'éléments que CollectionBase peut contenir.

Attributs

Exceptions

La valeur affectée à Capacity est inférieure à Count.

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é.

S’applique à

Voir aussi