Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Queue<T>::TrimExcess Method ()

 

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)

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 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.

Universal Windows Platform
Available since 8
.NET Framework
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show:
© 2017 Microsoft