Queue<T>.TrimExcess 方法

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

TrimExcess()	将容量设置为 Queue<T>中实际元素数（如果该数字小于当前容量的 90%）。
TrimExcess(Int32)	将 Queue<T> 对象的容量设置为指定的条目数。

将容量设置为 Queue<T>中实际元素数（如果该数字小于当前容量的 90%）。

public:
 void TrimExcess();

public void TrimExcess ();

member this.TrimExcess : unit -> unit

Public Sub TrimExcess ()

如果未将新元素添加到集合中，则此方法可用于最大程度地减少集合的内存开销。但是，重新分配和复制大型 Queue<T> 的成本可能相当大，因此，如果列表的容量超过 90%，TrimExcess 方法不会执行任何操作。这样就避免了相对较小的收益产生较大的重新分配成本。

此方法是一个 O（n）操作，其中 nCount。

若要将 Queue<T> 重置为其初始状态，请在调用 TrimExcess 方法之前调用 Clear 方法。剪裁空 Queue<T> 会将 Queue<T> 的容量设置为默认容量。

将 Queue<T> 对象的容量设置为指定的条目数。

public:
 void TrimExcess(int capacity);

public void TrimExcess (int capacity);

member this.TrimExcess : int -> unit

Public Sub TrimExcess (capacity As Integer)

新容量。

传递的容量低于条目计数。