Edit

SortedList<TKey,TValue>.TrimExcess Method

  • Reference

Definition

Namespace:
System.Collections.Generic
Assemblies:
System.dll, System.Collections.dll
Assembly:
System.Collections.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Source:
SortedList.cs
Source:
SortedList.cs
Source:
SortedList.cs

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.

public:
 void TrimExcess();
public void TrimExcess ();
member this.TrimExcess : unit -> unit
Public Sub 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<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.

Applies to

See also