TableRowGroupCollection.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 a capacidade de item de coleção pré-alocada 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, setPublic Property Capacity As IntegerValor da propriedade
A capacidade de item de coleção pré-alocada para esta coleção. O valor padrão é 8.
Exceções
Gerado quando uma tentativa é feita para definir 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 de 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 coleta, 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 em 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 de coleta seja igualada com a contagem de coleções atual.
