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.

SortedList<TKey, TValue>::TrimExcess Method ()

 

Sets the capacity to the actual number of elements in the SortedList<TKey, TValue>, 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 SortedList<TKey, TValue> 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 SortedList<TKey, TValue> to its initial state, call the Clear method before calling TrimExcess method. Trimming an empty SortedList<TKey, TValue> sets the capacity of the SortedList<TKey, TValue> to the default capacity.

The capacity can also be set using the Capacity property.

Universal Windows Platform
Available since 10
.NET Framework
Available since 2.0
Return to top
Show:
© 2017 Microsoft