SortedDictionary(TKey, TValue) Constructor

SortedDictionary(Of TKey, TValue) Constructor

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Initializes a new instance of the SortedDictionary(Of TKey, TValue) class that is empty and uses the default IComparer(Of T) implementation for the key type.

Namespace:  System.Collections.Generic
Assembly:  System (in System.dll)

'Declaration
Public Sub New

Every key in a SortedDictionary(Of TKey, TValue) must be unique according to the default comparer.

SortedDictionary(Of TKey, TValue) requires a comparer implementation to perform key comparisons. This constructor uses the default generic equality comparer Comparer(Of T).Default. If type TKey implements the System.IComparable(Of T) generic interface, the default comparer uses that implementation. Alternatively, you can specify an implementation of the IComparer(Of T) generic interface by using a constructor that accepts a comparer parameter.

This constructor is an O(1) operation.

The following code example creates an empty SortedDictionary(Of TKey, TValue) of strings with string keys and uses the Add method to add some elements. The example demonstrates that the Add method throws an ArgumentException when attempting to add a duplicate key.

This code example is part of a larger example provided for the SortedDictionary(Of TKey, TValue) class.

Windows Phone OS

Supported in: 8.1, 8.0

Show:
© 2017 Microsoft