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.