CollectionBase.Capacity Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o número de elementos que podem CollectionBase 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, setPublic Property Capacity As IntegerValor de Propriedade
O número de elementos que podem CollectionBase conter.
- Atributos
Exceções
Não há memória suficiente disponível no sistema.
Observações
Capacity é o número de elementos que a 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 Capacity ao adicionar elementos, a capacidade é automaticamente aumentada ao realocar o array interno antes de copiar os elementos antigos e adicionar os novos.
A capacidade pode ser reduzida definindo explicitamente a Capacity propriedade. Quando o valor de Capacity é definido explicitamente, o array interno também é realocado para acomodar a capacidade especificada.
Recuperar o valor desta propriedade é uma O(1) operação; definir a propriedade é uma O(n) operação, onde n é a nova capacidade.
