Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori