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

Reference

Definition

Namespace:: System.Collections.Immutable

Assembly:: System.Collections.Immutable.dll

Package:: System.Collections.Immutable v10.0.0-preview.1.25080.5

Source:: ImmutableStack_1.cs

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 dictionary.

public:
 System::Collections::Immutable::IImmutableDictionary<TKey, TValue> ^ Add(TKey key, TValue value);

public System.Collections.Immutable.IImmutableDictionary<TKey,TValue> Add(TKey key, TValue value);

abstract member Add : 'Key * 'Value -> System.Collections.Immutable.IImmutableDictionary<'Key, 'Value>

Public Function Add (key As TKey, value As TValue) As IImmutableDictionary(Of TKey, TValue)

Parameters

key: TKey

The key of the element to add.

value: TValue

The value of the element to add.

Returns

IImmutableDictionary<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, this method returns the existing instance of the dictionary.

Applies to

Product	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8 (package-provided), 8, 9 (package-provided), 9, 10 (package-provided), 10
.NET Standard	2.0 (package-provided)
UWP	10.0

Share via