WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

KeyNotFoundException — ein fehlender Schlüssel in einer Sammlung

System.Collections.Generic.KeyNotFoundException signalisiert den Versuch, ein Element mit einem Schlüssel abzurufen, der nicht vorhanden ist. Erfahre, wie sich Lese- und Schreibzugriffe auf den Indexer von Dictionary<TKey,TValue> unterscheiden und wann TryGetValue bei einem erwarteten fehlenden Schlüssel sinnvoll ist.

Version: .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 ist ein Ausnahmetyp, der signalisiert, dass versucht wird, ein Sammlungselement mit einem Schlüssel abzurufen, den die Sammlung nicht enthält. Der Typ ist in .NET 10 verfügbar; seine Verwendung erfordert keine Vorschau-Sprachfunktionen.

Bei Dictionary<TKey,TValue> löst das Lesen mit dictionary[key] diese Ausnahme aus, wenn der Schlüssel nicht vorhanden ist. Das Schreiben mit dictionary[key] = value verhält sich anders: Es fügt einen fehlenden Schlüssel hinzu oder ersetzt den Wert eines vorhandenen Schlüssels. Ein fehlender Schlüssel bedeutet also nicht, dass jeder Zugriff über den Indexer eine Ausnahme auslöst.

Wenn ein fehlender Schlüssel erwartet wird, verwende TryGetValue(key, out value), statt try/catch für den normalen Programmablauf einzusetzen. Die Methode gibt false zurück und weist dem Ausgabeparameter default(TValue) zu, wenn der Schlüssel fehlt. Bei int ist das 0; prüfe den booleschen Rückgabewert, denn 0 kann auch ein gültig gespeicherter Wert sein.

Das Beispiel löst absichtlich KeyNotFoundException aus und fängt sie ab. Anschließend zeigt es TryGetValue und das Hinzufügen des fehlenden Schlüssels durch eine Zuweisung. Der catch-Block gibt einen festen Text statt der System-Ausnahmemeldung aus, sodass die erwartete Ausgabe nicht von der Sprache der Laufzeitmeldung abhängt.

Beispiele

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

Ergebnis

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

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen