Прочитать на английском

Поделиться через


SortedList<TKey,TValue>.ContainsKey(TKey) Метод

Определение

Определяет, содержит ли объект SortedList<TKey,TValue> указанный ключ.

public bool ContainsKey (TKey key);

Параметры

key
TKey

Ключ, который требуется найти в SortedList<TKey,TValue>.

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

true, если SortedList<TKey,TValue> содержит элемент с указанным ключом, в противном случае — false.

Реализации

Исключения

key имеет значение null.

Примеры

В следующем примере кода показано, как использовать ContainsKey метод для проверки наличия ключа перед вызовом Add метода . В нем также показано, как использовать TryGetValue метод для получения значений, что является эффективным способом получения значений, когда программа часто пытается использовать ключи, которые не находятся в отсортированных списках. Наконец, он показывает наименее эффективный способ проверки наличия ключей с помощью Item[] свойства (индексатор в C#).

Этот пример входит в состав более крупного примера использования класса SortedList<TKey,TValue>.

// ContainsKey can be used to test keys before inserting
// them.
if (!openWith.ContainsKey("ht"))
{
    openWith.Add("ht", "hypertrm.exe");
    Console.WriteLine("Value added for key = \"ht\": {0}",
        openWith["ht"]);
}
// When a program often has to try keys that turn out not to
// be in the list, TryGetValue can be a more efficient
// way to retrieve values.
string value = "";
if (openWith.TryGetValue("tif", out value))
{
    Console.WriteLine("For key = \"tif\", value = {0}.", value);
}
else
{
    Console.WriteLine("Key = \"tif\" is not found.");
}
// The indexer throws an exception if the requested key is
// not in the list.
try
{
    Console.WriteLine("For key = \"tif\", value = {0}.",
        openWith["tif"]);
}
catch (KeyNotFoundException)
{
    Console.WriteLine("Key = \"tif\" is not found.");
}

Комментарии

Этот метод является операцией O(log n), где nCount.

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

Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

См. также раздел