TableRowGroupCollection.Capacity Propriété

Définition

Espace de noms:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Obtient ou définit la capacité d'éléments de collection pré-allouée à la collection.

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

Capacité d'éléments de collection pré-allouée à cette collection. La valeur par défaut est 8.

Exceptions

ArgumentOutOfRangeException

Levée lorsqu'une tentative de définition de Capacity sur une valeur inférieure à la valeur actuelle de Count est effectuée.

Remarques

La Capacity propriété représente le nombre d’emplacements pré-alloués pour le stockage des éléments dans cette collection, tandis que la Count propriété représente le nombre réel d’éléments actuellement dans la collection. La valeur de Capacity est toujours au moins égale à la valeur de Count.

Lorsque les éléments de collection nouvellement ajoutés entraînent le dépassement du nombre de regroupements, la capacité est automatiquement augmentée pour prendre en charge les éléments de collection nouvellement ajoutés. L’augmentation de la capacité de collecte implique l’allocation d’emplacements de collecte supplémentaires, ce qui entraîne une surcharge de performances et de mémoire. Utilisez la Capacity propriété pour optimiser la capacité de la collection dans les cas où le nombre total ou maximal d’éléments de collection est connu à l’avance. Utilisez la TrimToSize méthode pour que la capacité de la collection soit égalisée avec le nombre de regroupements actuel.

Voir aussi

• Count