Queue<T>.TrimExcess 方法

定義

命名空間:

System.Collections.Generic

組件:

netstandard.dll, System.Collections.dll

多載

TrimExcess()	如果這個數位小於目前容量的90%，請將容量設定為 Queue<T>中的實際項目數目。
TrimExcess(Int32)	將 Queue<T> 物件的容量設定為指定的項目數。

TrimExcess()

來源:

Queue.cs

如果這個數位小於目前容量的90%，請將容量設定為 Queue<T>中的實際項目數目。

C#

public void TrimExcess();

備註

如果集合中不會新增任何新元素，這個方法可用來將集合的記憶體額外負荷降到最低。 不過，重新配置和複製大型 Queue<T> 的成本可能相當大，因此，如果清單超過 90% 的容量，則 TrimExcess 方法不會執行任何動作。 這可避免產生相對較小的收益的大型重新配置成本。

這個方法是 O（n） 作業，其中 nCount。

若要將 Queue<T> 重設為其初始狀態，請先呼叫 Clear 方法，再呼叫 TrimExcess 方法。 修剪空白 Queue<T> 會將 Queue<T> 的容量設定為預設容量。

另請參閱

• Clear()
• Count

TrimExcess(Int32)

來源:

Queue.cs

將 Queue<T> 物件的容量設定為指定的項目數。

C#

public void TrimExcess(int capacity);

參數

capacity

Int32

新的容量。

例外狀況

ArgumentOutOfRangeException

傳遞的容量低於項目計數。