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é

Int32

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 ArrayList peut stocker. Count est le nombre d’éléments qui sont réellement dans le ArrayList .

Capacity est toujours supérieur ou égal à Count . Si est Count supérieur au Capacity moment d’ajouter des éléments, la capacité augmente automatiquement en réallouant 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 la Capacity propriété explicitement. Lorsque la valeur de Capacity est définie explicitement, le tableau interne est également réalloué pour s’adapter à 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