SortedList<TKey,TValue>.Capacity Propriedade

Definição

Namespace:

System.Collections.Generic

Assembly:

System.Collections.dll

Origem:

SortedList.cs

Obtém ou define o número de elementos que o SortedList<TKey,TValue> pode conter.

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

O número de elementos que o SortedList<TKey,TValue> pode conter.

Exceções

ArgumentOutOfRangeException

Capacity é definido como um valor menor que Count.

OutOfMemoryException

Não há memória suficiente disponível no sistema.

Comentários

Capacity é o número de elementos que o SortedList<TKey,TValue> pode armazenar. Count é o número de elementos que estão realmente no SortedList<TKey,TValue>.

Capacity é sempre maior ou igual a Count. Se Count exceder ao adicionar elementos Capacity , a capacidade será aumentada realocando automaticamente a matriz interna antes de copiar os elementos antigos e adicionar os novos elementos.

A capacidade pode ser reduzida chamando TrimExcess ou definindo a Capacity propriedade explicitamente. Quando o valor de Capacity é definido explicitamente, a matriz interna também é realocada para acomodar a capacidade especificada.

Recuperar o valor dessa propriedade é uma operação O(1) ; definir a propriedade é uma operação O(n), em que n é a nova capacidade.

Confira também

• Count
• TrimExcess()