Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri