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 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, 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 é 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 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 da coleção, a capacidade é aumentada automaticamente para acomodar os itens de coleção recém-adicionados. O aumento da capacidade de coleta envolve a alocação de 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.
