Queue<T>.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 Queue<T>, se esse número for inferior a 90 por cento da capacidade atual.
public:
void TrimExcess();
public void TrimExcess();
member this.TrimExcess : unit -> unit
Public 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 Queue<T> 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 Queue<T> ao seu estado inicial, chame o Clear método antes de chamar TrimExcess o método. Cortar um vazio Queue<T> define a capacidade do Queue<T> para a capacidade padrão.