Queue<T>.TrimExcess 方法

定义

重载

TrimExcess()

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

TrimExcess(Int32)

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

TrimExcess()

Source:
Queue.cs
Source:
Queue.cs
Source:
Queue.cs

将容量设置为 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> 的容量设置为默认容量。

另请参阅

适用于

TrimExcess(Int32)

Source:
Queue.cs

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

public:
 void TrimExcess(int capacity);
public void TrimExcess (int capacity);
member this.TrimExcess : int -> unit
Public Sub TrimExcess (capacity As Integer)

参数

capacity
Int32

新容量。

例外

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

适用于