Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C#

KeyNotFoundException — chýbajúci kľúč v kolekcii

System.Collections.Generic.KeyNotFoundException signalizuje pokus získať prvok pomocou kľúča, ktorý neexistuje. Zistite, ako sa líši čítanie a zápis pomocou indexera Dictionary<TKey,TValue> a kedy použiť TryGetValue, ak sa očakáva chýbajúci kľúč.

Verzia: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntax

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

System.Collections.Generic.KeyNotFoundException je typ výnimky, ktorý signalizuje pokus získať prvok kolekcie pomocou kľúča, ktorý kolekcia neobsahuje. Tento typ je dostupný v .NET 10; jeho použitie nevyžaduje jazykové funkcie vo verzii preview.

Pri Dictionary<TKey,TValue> vyvolá čítanie dictionary[key] túto výnimku, ak kľúč neexistuje. Zápis dictionary[key] = value sa správa inak: pridá chýbajúci kľúč alebo nahradí hodnotu existujúceho kľúča. Chýbajúci kľúč teda neznamená, že každá operácia s indexerom vyvolá výnimku.

Ak sa očakáva chýbajúci kľúč, použite TryGetValue(key, out value) namiesto použitia try/catch na bežné riadenie toku programu. Ak kľúč chýba, metóda vráti false a priradí výstupnému parametru default(TValue). Pre int je to 0; kontrolujte boolovský výsledok, pretože 0 môže byť aj platne uložená hodnota.

Príklad zámerne vyvolá a zachytí KeyNotFoundException, potom ukáže TryGetValue a pridanie chýbajúceho kľúča priradením. Blok catch vypíše pevný text namiesto systémovej správy výnimky, takže očakávaný výstup nezávisí od jazyka správ runtime prostredia.

Príklady

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"]);
    }
}

Výsledok

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

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje