Partilhar via


TableCellCollection.Capacity Propriedade

Definição

Obtém ou define a capacidade pré-alocada de item da coleção para esta coleção.

public:
 property int Capacity { int get(); void set(int value); };
public int Capacity { get; set; }
member this.Capacity : int with get, set
Public Property Capacity As Integer

Valor da propriedade

Int32

A capacidade de item de coleção preallocada para esta coleção. O valor padrão é 8.

Exceções

Gerado quando é feita uma tentativa de definir o Capacity como um valor menor que o valor atual de Count.

Comentários

A Capacity propriedade representa o número de slots preallocados para armazenar itens nesta coleção, enquanto a Count propriedade representa o número real de itens atualmente na coleção. O valor é Capacity sempre pelo menos tão grande quanto o valor de Count.

Quando os itens de coleção recém-adicionados fazem com que a contagem de coleções exceda a capacidade da coleção, a capacidade é aumentada automaticamente para acomodar os itens de coleção recém-adicionados. Aumentar a capacidade da coleção envolve alocar slots de coleção adicionais, o que incorre tanto no desempenho quanto na sobrecarga de memória. Use a Capacity propriedade para otimizar a capacidade da coleção nos casos em que o número total ou máximo de itens de coleção é conhecido com antecedência. Use o TrimToSize método para fazer com que a capacidade da coleção seja igualizada com a contagem de coleções atual.

Aplica-se a