Queue<T>.TrimExcess Method
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Sets the capacity to the actual number of elements in the Queue<T>, if that number is less than 90 percent of current capacity.
Namespace: System.Collections.Generic
Assembly: System (in System.dll)
Syntax
'Declaration
Public Sub TrimExcess
public void TrimExcess()
Remarks
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 Queue<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 Queue<T> to its initial state, call the Clear method before calling TrimExcess method. Trimming an empty Queue<T> sets the capacity of the Queue<T> to the default capacity.
Version Information
Silverlight
Supported in: 5, 4, 3
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0
XNA Framework
Supported in: Xbox 360, Windows Phone OS 7.0
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.