SortedList<TKey, TValue> Constructor (IComparer<TKey>^)
Initializes a new instance of the SortedList<TKey, TValue> class that is empty, has the default initial capacity, and uses the specified IComparer<T>.
Assembly: System (in System.dll)
Parameters
- comparer
-
Type:
System.Collections.Generic::IComparer<TKey>^
The IComparer<T> implementation to use when comparing keys.
-or-
null to use the default Comparer<T> for the type of the key.
Every key in a SortedList<TKey, TValue> must be unique according to the specified comparer.
This constructor uses the default value for the initial capacity of the SortedList<TKey, TValue>. To set the initial capacity, use the SortedList<TKey, TValue>(Int32, IComparer<TKey>^) constructor. If the final size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the SortedList<TKey, TValue>.
This constructor is an O(1) operation.
The following code example creates a sorted list with a case-insensitive comparer for the current culture. The example adds four elements, some with lower-case keys and some with upper-case keys. The example then attempts to add an element with a key that differs from an existing key only by case, catches the resulting exception, and displays an error message. Finally, the example displays the elements in case-insensitive sort order.
Available since 10
.NET Framework
Available since 2.0