Dictionary<TKey,TValue>.TryAdd(TKey, TValue) Methode

Definition

Namespace:

System.Collections.Generic

Assembly:

System.Collections.dll

Quelle:

Dictionary.cs

Versucht, dem Wörterbuch den angegebenen Schlüssel und Wert hinzuzufügen.

public:
 bool TryAdd(TKey key, TValue value);

public bool TryAdd (TKey key, TValue value);

member this.TryAdd : 'Key * 'Value -> bool

Public Function TryAdd (key As TKey, value As TValue) As Boolean

Parameter

key

TKey

Der Schlüssel des hinzuzufügenden Elements.

value

TValue

Der Wert des hinzuzufügenden Elements. Kann null sein.

Gibt zurück

Boolean

true, wenn das Schlüssel-Wert-Paar dem Wörterbuch erfolgreich hinzugefügt wurde, andernfalls false.

Ausnahmen

ArgumentNullException

key ist null

Hinweise

Add Im Gegensatz zur -Methode löst diese Methode keine Ausnahme aus, wenn das Element mit dem angegebenen Schlüssel im Wörterbuch vorhanden ist. Im Gegensatz zum Dictionary-Indexer wird das Element nicht außer Kraft gesetzt, TryAdd wenn das Element mit dem angegebenen Schlüssel im Wörterbuch vorhanden ist. Wenn der Schlüssel bereits vorhanden ist, TryAdd tut nichts und gibt zurück false.