CollectionBase.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 el número de elementos que puede contener CollectionBase.
public:
property int Capacity { int get(); void set(int value); };
public int Capacity { get; set; }
[System.Runtime.InteropServices.ComVisible(false)]
public int Capacity { get; set; }
member this.Capacity : int with get, set
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.Capacity : int with get, set
Public Property Capacity As Integer
Valor de propiedad
Número de elementos que puede contener CollectionBase.
- Atributos
Excepciones
No hay memoria suficiente en el sistema.
Comentarios
Capacity es el número de elementos que CollectionBase puede almacenar. Countes el número de elementos que se encuentran realmente en .CollectionBase
Capacity siempre es mayor o igual que Count. Si Count supera Capacity al agregar elementos, la capacidad aumenta automáticamente mediante la reasignación de la matriz interna antes de copiar los elementos antiguos y agregar los nuevos elementos.
La capacidad se puede reducir estableciendo la Capacity propiedad explícitamente. Cuando el valor de Capacity se establece explícitamente, la matriz interna también se reasigna para dar cabida a la capacidad especificada.
Recuperar el valor de esta propiedad es una O(1)
operación; establecer la propiedad es una O(n)
operación, donde n
es la nueva capacidad.