CKTIS / C#
KeyNotFoundException — chybějící klíč v kolekci
System.Collections.Generic.KeyNotFoundException oznamuje pokus získat prvek pomocí klíče, který neexistuje. Zjistěte, jak se liší čtení a zápis pomocí indexeru Dictionary<TKey,TValue> a kdy použít TryGetValue, pokud se očekává chybějící klíč.
Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
try { var value = dictionary[key]; }
catch (System.Collections.Generic.KeyNotFoundException) { /* Handle the missing key. */ }System.Collections.Generic.KeyNotFoundException je typ výjimky, který oznamuje pokus získat prvek kolekce pomocí klíče, který kolekce neobsahuje. Tento typ je dostupný v .NET 10; jeho použití nevyžaduje jazykové funkce ve verzi preview.
U Dictionary<TKey,TValue> vyvolá čtení dictionary[key] tuto výjimku, pokud klíč neexistuje. Zápis dictionary[key] = value se chová jinak: přidá chybějící klíč, nebo nahradí hodnotu existujícího klíče. Chybějící klíč tedy neznamená, že každá operace s indexerem vyvolá výjimku.
Pokud se očekává, že klíč chybí, použijte TryGetValue(key, out value) místo použití try/catch pro běžný tok programu. Pokud klíč není přítomen, metoda vrátí false a přiřadí výstupnímu parametru default(TValue). Pro int je to 0; kontrolujte logický výsledek, protože 0 může být také platně uložená hodnota.
Příklad záměrně vyvolá a zachytí KeyNotFoundException, potom ukáže TryGetValue a přidání chybějícího klíče přiřazením. Blok catch vypíše pevný text namísto systémové zprávy výjimky, takže očekávaný výstup nezávisí na jazyce zpráv běhového prostředí.
Pří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ýsledek
Missing key: Lin Not found; out value: 0 20
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.