ImmutableDictionary<TKey,TValue>.Add(TKey, TValue) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Adds an element with the specified key and value to the immutable dictionary.
public:
System::Collections::Immutable::ImmutableDictionary<TKey, TValue> ^ Add(TKey key, TValue value);
public System.Collections.Immutable.ImmutableDictionary<TKey,TValue> Add (TKey key, TValue value);
member this.Add : 'Key * 'Value -> System.Collections.Immutable.ImmutableDictionary<'Key, 'Value>
Public Function Add (key As TKey, value As TValue) As ImmutableDictionary(Of TKey, TValue)
Parameters
- key
- TKey
The key of the element to add.
- value
- TValue
The value of the element to add.
Returns
A new immutable dictionary that contains the additional key/value pair.
Exceptions
The given key already exists in the dictionary but has a different value.
Remarks
If the given key/value pair already exists in the dictionary, the existing instance of the dictionary is returned.