TableRowGroupCollection.Capacity Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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, setPublic Property Capacity As IntegerValor 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.
