Esta documentación está archivada y no tiene mantenimiento.

CollectionBase.Capacity (Propiedad)

Actualización: noviembre 2007

Obtiene o establece el número de elementos que puede contener la colección CollectionBase.

Espacio de nombres:  System.Collections
Ensamblado:  mscorlib (en mscorlib.dll)

[ComVisibleAttribute(false)]
public int Capacity { get; set; }
/** @property */
/** @attribute ComVisibleAttribute(false) */
public int get_Capacity()
/** @property */
/** @attribute ComVisibleAttribute(false) */
public  void set_Capacity(int value)

public function get Capacity () : int
public function set Capacity (value : int)

Valor de propiedad

Tipo: System.Int32
Número de elementos que puede contener la colección CollectionBase.

ExcepciónCondición
ArgumentOutOfRangeException

Capacity se establece en un valor menor que Count.

OutOfMemoryException

No hay suficiente memoria disponible en el sistema.

Capacity es el número de elementos que CollectionBase puede contener. Count es el número de elementos que están realmente en la colección CollectionBase.

Capacity es siempre mayor o igual que Count. Si el valor de la propiedad Count supera al de la propiedad Capacity cuando se agregan elementos, la capacidad se incrementa automáticamente mediante la reasignación de la matriz interna antes de copiar los elementos antiguos y agregar los nuevos.

Para disminuir la capacidad, establezca explícitamente la propiedad Capacity. Cuando el valor de Capacity se establece explícitamente, la matriz interna se reasigna para alojar la capacidad especificada.

La recuperación del valor de esta propiedad es una operación O(1); el establecimiento de la propiedad es una operación O(n), donde n es la nueva capacidad.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC, Xbox 360

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0

.NET Compact Framework

Compatible con: 3.5, 2.0

XNA Framework

Compatible con: 2.0, 1.0
Mostrar: