System.Collections.Generic.SortedList<TKey,TValue>.TrimExcess Method

Sets the capacity to the actual number of elements in the SortedList`2, if that number is less than 90 percent of current capacity.

Syntax

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 SortedList`2 can be considerable, however, so the SortedList`2.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 SortedList`2.Count.

To reset a SortedList`2 to its initial state, call the SortedList`2.Clear method before calling SortedList`2.TrimExcess method. Trimming an empty SortedList`2 sets the capacity of the SortedList`2 to the default capacity.

The capacity can also be set using the SortedList`2.Capacity property.

Requirements

Namespace: System.Collections.Generic
Assembly: System (in System.dll)
Assembly Versions: 2.0.0.0, 4.0.0.0
Since: .NET 2.0