Stack<T>.TrimExcess Stack<T>.TrimExcess Stack<T>.TrimExcess Stack<T>.TrimExcess Method


Stack<T> 内にある実際の要素数が現在の容量の 90% 未満の場合は、容量をその数に設定します。Sets the capacity to the actual number of elements in the Stack<T>, if that number is less than 90 percent of current capacity.

 void TrimExcess();
public void TrimExcess ();
member this.TrimExcess : unit -> unit
Public Sub TrimExcess ()


このメソッドは、コレクションのメモリ オーバーヘッドを最小要素がコレクションに追加されない場合に使用できます。This method can be used to minimize a collection's memory overhead if no new elements will be added to the collection. 再割り当てすることと、大規模なコピーのコストStack<T>は適さない、ただし、そのため、TrimExcess一覧は、「容量の 90% を超える場合メソッドは何も行いません。The cost of reallocating and copying a large Stack<T> can be considerable, however, so the TrimExcess method does nothing if the list is at more than 90 percent of capacity. 比較的小規模の向上のための大規模な再割り当てコストの発生を回避できます。This avoids incurring a large reallocation cost for a relatively small gain.

このメソッドは O (n) 操作、nCountします。This method is an O(n) operation, where n is Count.

リセットする、Stack<T>を初期状態を呼び出し、Clearメソッドを呼び出す前にTrimExcessメソッド。To reset a Stack<T> to its initial state, call the Clear method before calling TrimExcess method. 空のトリミングStack<T>の容量設定、Stack<T>を既定の容量。Trimming an empty Stack<T> sets the capacity of the Stack<T> to the default capacity.