Partage via


ArrayList.Capacity Propriété

Définition

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

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

Valeur de propriété

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

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 le ArrayList peut stocker. Countest le nombre d’éléments qui se trouvent réellement dans .ArrayList

Capacity est toujours supérieur ou égal à Count. Si Count 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 appelant TrimToSize ou en définissant explicitement la Capacity propriété. 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