База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C#

KeyNotFoundException — липсващ ключ в колекция

System.Collections.Generic.KeyNotFoundException сигнализира опит за извличане на елемент с ключ, който не съществува. Научете как се различават четенето и записването чрез индексатора на Dictionary<TKey,TValue> и кога да използвате TryGetValue, ако се очаква липсващ ключ.

Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Синтаксис

try { var value = dictionary[key]; }
catch (System.Collections.Generic.KeyNotFoundException) { /* Handle the missing key. */ }

System.Collections.Generic.KeyNotFoundException е тип изключение, който сигнализира опит за извличане на елемент от колекция с ключ, който тя не съдържа. Типът е наличен в .NET 10; използването му не изисква езикови функции от preview версия.

При Dictionary<TKey,TValue> четенето на dictionary[key] предизвиква това изключение, ако ключът не съществува. Записването на dictionary[key] = value се държи различно: добавя липсващ ключ или заменя стойността на съществуващ ключ. Следователно липсващ ключ не означава, че всяка операция с индексатора предизвиква изключение.

Когато се очаква ключът да липсва, използвайте TryGetValue(key, out value), вместо да използвате try/catch за обичайния ход на програмата. Ако ключът липсва, методът връща false и присвоява default(TValue) на изходния параметър. За int това е 0; проверявайте булевия резултат, защото 0 може да бъде и валидно записана стойност.

Примерът умишлено предизвиква и прихваща KeyNotFoundException, след което показва TryGetValue и добавянето на липсващия ключ чрез присвояване. Блокът catch отпечатва фиксиран текст вместо системното съобщение за изключението, така че очакваният изход не зависи от езика на съобщенията на средата за изпълнение.

Примери

using System;
using System.Collections.Generic;

internal static class Program
{
    private static void Main()
    {
        var scores = new Dictionary<string, int>
        {
            ["Ada"] = 10
        };

        try
        {
            Console.WriteLine(scores["Lin"]);
        }
        catch (KeyNotFoundException)
        {
            Console.WriteLine("Missing key: Lin");
        }

        if (!scores.TryGetValue("Lin", out int score))
        {
            Console.WriteLine($"Not found; out value: {score}");
        }

        scores["Lin"] = 20;
        Console.WriteLine(scores["Lin"]);
    }
}

Резултат

Missing key: Lin
Not found; out value: 0
20

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници