ImmutableDictionary<TKey,TValue>.Add(TKey, TValue) Method

Definition

Namespace:

System.Collections.Immutable

Assembly:

System.Collections.Immutable.dll

Package:

System.Collections.Immutable v9.0.0-rc.2.24473.5

Source:

ImmutableDictionary_2.cs

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

ImmutableDictionary<TKey,TValue>

A new immutable dictionary that contains the additional key/value pair.

Exceptions

ArgumentException

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.