Dictionary<TKey,TValue>.TrimExcess 方法

定義

命名空間:

System.Collections.Generic

組件:

System.Collections.dll

多載

TrimExcess(Int32)	將此字典容量設定為最多可以保留的指定項目數量，但不必進一步擴充其支援儲存體。
TrimExcess()	將此字典容量設定為一開始若使用所有項目初始化的應有容量。

TrimExcess(Int32)

來源:

Dictionary.cs

將此字典容量設定為最多可以保留的指定項目數量，但不必進一步擴充其支援儲存體。

public:
 void TrimExcess(int capacity);

public void TrimExcess (int capacity);

member this.TrimExcess : int -> unit

Public Sub TrimExcess (capacity As Integer)

參數

capacity

Int32

新的容量。

例外狀況

ArgumentOutOfRangeException

capacity 小於 Count。

備註

這個方法可用來將已知不會新增任何新元素的記憶體額外負荷降到最低。

TrimExcess()

來源:

Dictionary.cs

將此字典容量設定為一開始若使用所有項目初始化的應有容量。

public:
 void TrimExcess();

public void TrimExcess ();

member this.TrimExcess : unit -> unit

Public Sub TrimExcess ()

備註

一旦知道字典中不會新增任何新元素，這個方法就可以用來將記憶體額外負荷降到最低。 若要設定最小大小的記憶體數位，請執行下列語句：

dictionary.Clear();
dictionary.TrimExcess();