Dictionary<TKey,TValue>.TryAdd(TKey, TValue) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Пытается добавить указанную пару "ключ-значение" в словарь.
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
Ключ добавляемого элемента.
- value
- TValue
Добавляемое значение элемента. Это может быть null
.
Возвращаемое значение
Значение true
, если пара "ключ-значение" была успешно добавлена в словарь; в противном случае — значение false
.
Исключения
key
имеет значение null
.
Комментарии
Add В отличие от метода, этот метод не создает исключение, если элемент с заданным ключом существует в словаре. В отличие от индексатора Dictionary, не переопределяет элемент , TryAdd
если элемент с заданным ключом существует в словаре. Если ключ уже существует, TryAdd
ничего не делает и возвращает false
.