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

Definition

Versucht, dem Wörterbuch den angegebenen Schlüssel und Wert hinzuzufügen.Attempts to add the specified key and value to the dictionary.

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

Parameters

key
TKey

Der Schlüssel des hinzuzufügenden Elements.The key of the element to add.

value
TValue

Der Wert des hinzuzufügenden Elements.The value of the element to add. Kann null sein.It can be null.

Returns

Boolean

true, wenn das Schlüssel-Wert-Paar dem Wörterbuch erfolgreich hinzugefügt wurde, andernfalls false.true if the key/value pair was added to the dictionary successfully; otherwise, false.

Exceptions

key ist nullkey is null.

Remarks

Anders als bei der Add-Methode löst diese Methode keine Ausnahme aus, wenn das Element mit dem angegebenen Schlüssel im Wörterbuch vorhanden ist.Unlike the Add method, this method doesn't throw an exception if the element with the given key exists in the dictionary. Im Gegensatz zum Wörterbuch Indexer überschreibt TryAdd das-Element nicht, wenn das Element mit dem angegebenen Schlüssel im Wörterbuch vorhanden ist.Unlike the Dictionary indexer, TryAdd doesn't override the element if the element with the given key exists in the dictionary. Wenn der Schlüssel bereits vorhanden ist, führt TryAdd keine Aktion aus und gibt falsezurück.If the key already exists, TryAdd does nothing and returns false.

Applies to