Compartir vía


TableRowGroupCollection.Capacity Propiedad

Definición

Obtiene o establece la capacidad de elementos de colección preasignada para esta colección.

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

Valor de propiedad

Capacidad de elementos de colección preasignada para esta colección. El valor predeterminado es 8.

Excepciones

Se produce cuando se realiza un intento para establecer Capacity en un valor que sea menor que el valor actual de Count.

Comentarios

La Capacity propiedad representa el número de ranuras asignadas previamente para almacenar elementos en esta colección, mientras que la Count propiedad representa el número real de elementos que se encuentran actualmente en la colección. El valor de Capacity siempre es al menos tan grande como el valor de Count.

Cuando los elementos de colección recién agregados hacen que el recuento de colecciones supere la capacidad de recopilación, la capacidad aumenta automáticamente para dar cabida a los elementos de colección recién agregados. Aumentar la capacidad de recopilación implica asignar ranuras de recopilación adicionales, lo que incurre tanto en la sobrecarga de rendimiento como en la memoria. Utilice la propiedad para optimizar la Capacity capacidad de recopilación en los casos en los que se conoce de antemano el número total o máximo de elementos de colección. Use el TrimToSize método para hacer que la capacidad de recopilación sea igualada con el recuento de colecciones actual.

Se aplica a

Consulte también