TableColumnCollection.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 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 recopilaciones 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 la asignación de ranuras de recopilación adicionales, lo que conlleva tanto el rendimiento como la sobrecarga de memoria. Utilice la Capacity propiedad para optimizar la capacidad de recopilación en los casos en los que el número total o máximo de elementos de colección se conozca de antemano. Use el TrimToSize método para hacer que la capacidad de recopilación sea igualada con el recuento de recopilación actual.
