CKTIS / C#
KeyNotFoundException — manjkajoči ključ v zbirki
System.Collections.Generic.KeyNotFoundException označuje poskus pridobitve elementa s ključem, ki ne obstaja. Spoznajte razliko med branjem in pisanjem z indeksatorjem Dictionary<TKey,TValue> ter kdaj uporabiti TryGetValue, če pričakujete manjkajoči ključ.
Različica: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
try { var value = dictionary[key]; }
catch (System.Collections.Generic.KeyNotFoundException) { /* Handle the missing key. */ }System.Collections.Generic.KeyNotFoundException je vrsta izjeme, ki označuje poskus pridobitve elementa zbirke s ključem, ki ga zbirka ne vsebuje. Vrsta je na voljo v .NET 10; njena uporaba ne zahteva jezikovnih funkcij različice preview.
Pri Dictionary<TKey,TValue> branje dictionary[key] sproži to izjemo, če ključ ne obstaja. Pisanje dictionary[key] = value deluje drugače: doda manjkajoči ključ ali zamenja vrednost obstoječega ključa. Manjkajoči ključ torej ne pomeni, da vsaka operacija z indeksatorjem sproži izjemo.
Če pričakujete, da ključ manjka, uporabite TryGetValue(key, out value) namesto try/catch za običajen potek programa. Če ključa ni, metoda vrne false in izhodnemu parametru dodeli default(TValue). Pri int je to 0; preverite logični rezultat, saj je 0 lahko tudi veljavno shranjena vrednost.
Primer namenoma sproži in prestreže KeyNotFoundException, nato pa prikaže TryGetValue in dodajanje manjkajočega ključa z dodelitvijo. Blok catch izpiše nespremenljivo besedilo namesto sistemskega sporočila izjeme, zato pričakovani izpis ni odvisen od jezika sporočil izvajalnega okolja.
Primeri
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"]);
}
}Rezultat
Missing key: Lin Not found; out value: 0 20
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.