SortedList<TKey,TValue>.Capacity Propriété

Définition

Espace de noms:

System.Collections.Generic

Assembly:

System.Collections.dll

Source:

SortedList.cs

Obtient ou définit le nombre d'éléments que SortedList<TKey,TValue> peut contenir.

public:
 property int Capacity { int get(); void set(int value); };

public int Capacity { get; set; }

member this.Capacity : int with get, set

Public Property Capacity As Integer

Valeur de propriété

Int32

Nombre initial d'éléments que SortedList<TKey,TValue> peut contenir.

Exceptions

ArgumentOutOfRangeException

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

OutOfMemoryException

Il n’y a pas assez de mémoire disponible sur le système.

Remarques

Capacity est le nombre d’éléments que le SortedList<TKey,TValue> peut stocker. Countest le nombre d’éléments qui se trouvent réellement dans .SortedList<TKey,TValue>

Capacity est toujours supérieur ou égal à Count. Si Count dépasse lors de Capacity l’ajout d’éléments, la capacité est augmentée en réaffectant automatiquement 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 TrimExcess 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 opération O(1) ; la définition de la propriété est une opération O(n), où n est la nouvelle capacité.

Voir aussi

• Count
• TrimExcess()