Partilhar via


TableRowCollection.Capacity Propriedade

Definição

Obtém ou define a capacidade do item da coleção pré-alocado 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 pré-alocada 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 pré-alocados 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 de coleção, a capacidade é automaticamente aumentada 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 igualada com a contagem de coleções atual.

Aplica-se a

Confira também