CollectionBase.Capacity Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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, setPublic Property Capacity As IntegerValor da propriedade
O número de elementos que o CollectionBase pode conter.
- Atributos
Exceções
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.
