SortedList<TKey,TValue>.TrimExcess Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Define a capacidade para o número real de elementos no SortedList<TKey,TValue>, se esse número for inferior a 90 por cento da capacidade atual.
public:
void TrimExcess();public void TrimExcess();member this.TrimExcess : unit -> unitPublic Sub TrimExcess ()Observações
Este método pode ser usado para minimizar a sobrecarga de memória de uma coleção caso não sejam adicionados novos elementos à coleção. No entanto, o custo de realocar e copiar um grande SortedList<TKey,TValue> pode ser considerável, por isso o TrimExcess método não faz nada se a lista estiver a mais de 90 por cento da capacidade. Isto evita incorrer num custo elevado de realocação por um ganho relativamente pequeno.
Este método é uma operação O(n), onde n é Count.
Para reiniciar a SortedList<TKey,TValue> ao seu estado inicial, chame o Clear método antes de chamar TrimExcess o método. Cortar um vazio SortedList<TKey,TValue> define a capacidade do SortedList<TKey,TValue> para a capacidade padrão.
A capacidade também pode ser definida usando a Capacity propriedade.
