ArrayList.Capacity Propriedade

Definição

Namespace:

System.Collections

Assembly:

System.Runtime.dll

Origem:

ArrayList.cs

Obtém ou define o número de elementos que o ArrayList pode conter.

public:
 virtual property int Capacity { int get(); void set(int value); };

public virtual int Capacity { get; set; }

member this.Capacity : int with get, set

Public Overridable Property Capacity As Integer

Valor da propriedade

Int32

O número de elementos que o ArrayList pode conter.

Exceções

ArgumentOutOfRangeException

Capacity é definido como um valor menor que Count.

OutOfMemoryException

Não há memória suficiente disponível no sistema.

Comentários

Capacity é o número de elementos que o ArrayList pode armazenar. Count é o número de elementos que estão realmente no ArrayList.

Capacity é sempre maior ou igual a Count. Se Count exceder ao adicionar elementos Capacity , a capacidade será automaticamente aumentada realocando a matriz interna antes de copiar os elementos antigos e adicionar os novos elementos.

A capacidade pode ser reduzida chamando TrimToSize ou definindo a Capacity propriedade explicitamente. Quando o valor de Capacity é definido explicitamente, a matriz interna também é realocada para acomodar a capacidade especificada.

Recuperar o valor dessa propriedade é uma O(1) operação; definir a propriedade é uma O(n) operação, em que n é a nova capacidade.

Confira também

• Count