IReadOnlyDictionary<TKey,TValue>.TryGetValue(TKey, TValue) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает значение, связанное с указанным ключом.
public:
bool TryGetValue(TKey key, [Runtime::InteropServices::Out] TValue % value);
public bool TryGetValue (TKey key, out TValue value);
abstract member TryGetValue : 'Key * 'Value -> bool
Public Function TryGetValue (key As TKey, ByRef value As TValue) As Boolean
Параметры
- key
- TKey
Искомый ключ.
- value
- TValue
Этот метод возвращает значение, связанное с указанным ключом, если он найден; в противном случае — значение по умолчанию для данного типа параметра value
. Этот параметр передается неинициализированным.
Возвращаемое значение
Значение true
, если объект, который реализует интерфейс IReadOnlyDictionary<TKey,TValue>, содержит элемент, имеющий указанный ключ; в противном случае — значение false
.
Исключения
key
имеет значение null
.
Комментарии
Этот метод объединяет функциональные возможности ContainsKey метода и Item[] свойства .
Если ключ не найден, value
параметр получает соответствующее значение по умолчанию для типа TValue
: например, 0 (ноль) для целочисленных типов, false
для логических типов и null
ссылочных типов.