CKTIS / C#
KeyNotFoundException — ključ koji nedostaje u kolekciji
System.Collections.Generic.KeyNotFoundException označava pokušaj dohvaćanja elementa pomoću ključa koji ne postoji. Saznajte po čemu se razlikuju čitanje i pisanje pomoću indeksatora Dictionary<TKey,TValue> te kada upotrijebiti TryGetValue ako se očekuje da ključ nedostaje.
Verzija: .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 vrsta je iznimke koja označava pokušaj dohvaćanja elementa kolekcije pomoću ključa koji kolekcija ne sadrži. Ta je vrsta dostupna u .NET 10; za njezinu upotrebu nisu potrebne jezične značajke preview verzije.
Kod Dictionary<TKey,TValue>, čitanje dictionary[key] izaziva ovu iznimku ako ključ ne postoji. Pisanje dictionary[key] = value ponaša se drukčije: dodaje ključ koji nedostaje ili zamjenjuje vrijednost postojećeg ključa. Dakle, ključ koji nedostaje ne znači da će svaka operacija indeksatora izazvati iznimku.
Kada se očekuje da ključ nedostaje, upotrijebite TryGetValue(key, out value) umjesto try/catch za uobičajeni tijek programa. Ako ključ nije prisutan, metoda vraća false i dodjeljuje default(TValue) izlaznom parametru. Za int to je 0; provjerite logički rezultat jer 0 može biti i valjano pohranjena vrijednost.
Primjer namjerno izaziva i hvata KeyNotFoundException, a zatim prikazuje TryGetValue i dodavanje ključa koji nedostaje pomoću dodjele. Blok catch ispisuje fiksni tekst umjesto sistemske poruke iznimke, pa očekivani izlaz ne ovisi o jeziku poruka okruženja izvođenja.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.