Partilhar via


ArrayList.Capacity Propriedade

Definição

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

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

Exceções

Capacity é definido como um valor menor que Count.

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.

Aplica-se a

Confira também