Partage via


CollectionBase.Capacity Propriété

Définition

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, set
Public Property Capacity As Integer

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