Dictionary<TKey,TValue>.TryAdd(TKey, TValue) Метод

Определение

Пытается добавить указанную пару "ключ-значение" в словарь.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

Параметры

key
TKey

Ключ добавляемого элемента.The key of the element to add.

value
TValue

Значение элемента для добавления.The value of the element to add. Это может быть null.It can be null.

Возвращаемое значение

Значение true, если пара "ключ-значение" была успешно добавлена в словарь; в противном случае — значение false.true if the key/value pair was added to the dictionary successfully; otherwise, false.

Исключения

Свойство key имеет значение null.key is null.

Комментарии

В отличие от метода Add, этот метод не создает исключение, если элемент с заданным ключом существует в словаре.Unlike the Add method, this method doesn't throw an exception if the element with the given key exists in the dictionary. В отличие от индексатора словаря, TryAdd не переопределяет элемент, если элемент с заданным ключом существует в словаре.Unlike the Dictionary indexer, TryAdd doesn't override the element if the element with the given key exists in the dictionary. Если ключ уже существует, TryAdd не выполняет никаких действий и возвращает false.If the key already exists, TryAdd does nothing and returns false.

Применяется к