SortedDictionary<TKey, TValue>::Add Method (TKey, TValue)
Adds an element with the specified key and value into the SortedDictionary<TKey, TValue>.
Assembly: System (in System.dll)
| Exception | Condition |
|---|---|
| ArgumentNullException | key is null. |
| ArgumentException | An element with the same key already exists in the SortedDictionary<TKey, TValue>. |
You can also use the Item property to add new elements by setting the value of a key that does not exist in the SortedDictionary<TKey, TValue>; for example, myCollection["myNonexistentKey"] = myValue (in Visual Basic, myCollection("myNonexistantKey") = myValue). However, if the specified key already exists in the SortedDictionary<TKey, TValue>, setting the Item property overwrites the old value. In contrast, the Addmethod throws an exception if an element with the specified key already exists.
A key cannot be null, but a value can be, if the value type TValue is a reference type.
This method is an O(log n) operation, where n is Count.
The following code example creates an empty SortedDictionary<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<TKey, TValue> class.
Available since 8
.NET Framework
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Windows Phone Silverlight
Available since 8.0
Windows Phone
Available since 8.1