Dictionary<'TKey, 'TValue> Constructor (IDictionary<'TKey, 'TValue>)
Initializes a new instance of the Dictionary<'TKey, 'TValue> class that contains elements copied from the specified IDictionary<'TKey, 'TValue> and uses the default equality comparer for the key type.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- dictionary
-
Type:
System.Collections.Generic.IDictionary<'TKey, 'TValue>
The IDictionary<'TKey, 'TValue> whose elements are copied to the new Dictionary<'TKey, 'TValue>.
| Exception | Condition |
|---|---|
| ArgumentNullException | dictionary is null. |
| ArgumentException | dictionary contains one or more duplicate keys. |
Every key in a Dictionary<'TKey, 'TValue> must be unique according to the default equality comparer; likewise, every key in the source dictionary must also be unique according to the default equality comparer.
The initial capacity of the new Dictionary<'TKey, 'TValue> is large enough to contain all the elements in dictionary.
Dictionary<'TKey, 'TValue> requires an equality implementation to determine whether keys are equal. This constructor uses the default generic equality comparer, EqualityComparer<'T>.Default. If type TKey implements the System.IEquatable<'T> generic interface, the default equality comparer uses that implementation. Alternatively, you can specify an implementation of the IEqualityComparer<'T> generic interface by using a constructor that accepts a comparer parameter.
This constructor is an O(n) operation, where n is the number of elements in dictionary.
The following code example shows how to use the Dictionary<'TKey, 'TValue>(IEqualityComparer<'TKey>) constructor to initialize a Dictionary<'TKey, 'TValue> with sorted content from another dictionary. The code example creates a SortedDictionary<'TKey, 'TValue> and populates it with data in random order, then passes the SortedDictionary<'TKey, 'TValue> to the Dictionary<'TKey, 'TValue>(IEqualityComparer<'TKey>) constructor, creating a Dictionary<'TKey, 'TValue> that is sorted. This is useful if you need to build a sorted dictionary that at some point becomes static; copying the data from a SortedDictionary<'TKey, 'TValue> to a Dictionary<'TKey, 'TValue> improves retrieval speed.
Available since 8
.NET Framework
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1