KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

KeyNotFoundException — een ontbrekende sleutel in een verzameling

System.Collections.Generic.KeyNotFoundException geeft aan dat een element wordt opgehaald met een sleutel die niet bestaat. Lees hoe lees- en schrijfoperaties met de indexer van Dictionary<TKey,TValue> van elkaar verschillen en wanneer je TryGetValue gebruikt als een ontbrekende sleutel wordt verwacht.

Versie: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntax

try { var value = dictionary[key]; }
catch (System.Collections.Generic.KeyNotFoundException) { /* Handle the missing key. */ }

System.Collections.Generic.KeyNotFoundException is een uitzonderingstype dat aangeeft dat wordt geprobeerd een element uit een verzameling op te halen met een sleutel die de verzameling niet bevat. Het type is beschikbaar in .NET 10; het gebruik ervan vereist geen preview-taalfuncties.

Bij Dictionary<TKey,TValue> veroorzaakt het lezen van dictionary[key] deze uitzondering als de sleutel niet bestaat. Schrijven met dictionary[key] = value werkt anders: hiermee wordt een ontbrekende sleutel toegevoegd of de waarde van een bestaande sleutel vervangen. Een ontbrekende sleutel betekent dus niet dat elke indexerbewerking een uitzondering veroorzaakt.

Als een ontbrekende sleutel wordt verwacht, gebruik dan TryGetValue(key, out value) in plaats van try/catch voor de normale programmastroom. De methode retourneert false en kent default(TValue) toe aan de uitvoerparameter als de sleutel ontbreekt. Voor int is dat 0; controleer de Booleaanse uitkomst, omdat 0 ook een geldige opgeslagen waarde kan zijn.

Het voorbeeld veroorzaakt en vangt bewust KeyNotFoundException op en laat daarna TryGetValue en het toevoegen van de ontbrekende sleutel via een toewijzing zien. Het catch-blok drukt vaste tekst af in plaats van het systeembericht van de uitzondering, zodat de verwachte uitvoer niet afhankelijk is van de taal van de runtimeberichten.

Voorbeelden

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"]);
    }
}

Resultaat

Missing key: Lin
Not found; out value: 0
20

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen