• Article

Dictionary<TKey, TValue> Constructor (IDictionary<TKey, TValue>)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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.

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

Syntax

'Declaration
Public Sub New ( _
    dictionary As IDictionary(Of TKey, TValue) _
)

public Dictionary(
    IDictionary<TKey, TValue> dictionary
)

Parameters

Exceptions

Exception Condition
ArgumentNullException

dictionary is nulla null reference (Nothing in Visual Basic).
ArgumentException

dictionary contains one or more duplicate keys.

Remarks

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.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.