Stack<T>.TrimExcess Method

Sets the capacity to the actual number of elements in the Stack<T>, if that number is less than 90 percent of current capacity.

Namespace:  System.Collections.Generic
Assembly:  System (in System.dll)

public void TrimExcess()

This method can be used to minimize a collection's memory overhead if no new elements will be added to the collection. 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.

This method is an O(n) operation, where n is Count.

To reset a Stack<T> to its initial state, call the Clear method before calling TrimExcess method. Trimming an empty Stack<T> sets the capacity of the Stack<T> to the default capacity.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft