TableColumnCollection.Capacity Propiedad

Definición

Espacio de nombres:

System.Windows.Documents

Ensamblado:

PresentationFramework.dll

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

Int32

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

Excepciones

ArgumentOutOfRangeException

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.

Consulte también

• Count