CollectionBase.Capacity Propriedade

Definição

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

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 da propriedade

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

Atributos

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 CollectionBase pode armazenar. Count é o número de elementos que estão realmente no CollectionBase.

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 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