SortedList<TKey,TValue>.TrimExcess Método
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.
Definirá a capacidade para o número real de elementos no SortedList<TKey,TValue>, se esse número for menor que 90% da capacidade atual.
public:
void TrimExcess();
public void TrimExcess ();
member this.TrimExcess : unit -> unit
Public Sub TrimExcess ()
Comentários
Esse método pode ser usado para minimizar a sobrecarga de memória de uma coleção se nenhum elemento novo for adicionado à coleção. No entanto, o custo de realocar e copiar um grande SortedList<TKey,TValue> pode ser considerável, portanto, o TrimExcess método não fará nada se a lista estiver em mais de 90% da capacidade. Isso evita incorrer em um grande custo de realocação para um ganho relativamente pequeno.
Este método é uma operação O(n
), em que n
é Count.
Para redefinir um SortedList<TKey,TValue> para seu estado inicial, chame o método antes de chamar TrimExcess o Clear método . Cortar um vazio SortedList<TKey,TValue> define a capacidade do SortedList<TKey,TValue> como a capacidade padrão.
A capacidade também pode ser definida usando a Capacity propriedade .