Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje