CollectionBase.Capacity Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Collections
Ensamblados:
mscorlib.dll, System.Collections.NonGeneric.dll
Ensamblado:
System.Collections.NonGeneric.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll
Source:
CollectionBase.cs
Source:
CollectionBase.cs
Source:
CollectionBase.cs

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

Int32

Número de elementos que puede contener CollectionBase.

Atributos
ComVisibleAttribute

Excepciones

ArgumentOutOfRangeException

Capacity se establece en un valor que es menor que Count.

OutOfMemoryException

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.

Se aplica a

Consulte también