TableCellCollection.Capacity Propriedade

Definição

Namespace:

System.Windows.Documents

Assembly:

PresentationFramework.dll

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

ArgumentOutOfRangeException

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.