CKTIS / C#
KeyNotFoundException — brak klucza w kolekcji
System.Collections.Generic.KeyNotFoundException sygnalizuje próbę pobrania elementu za pomocą nieistniejącego klucza. Poznaj różnicę między odczytem i zapisem przez indeksator Dictionary<TKey,TValue> oraz użycie TryGetValue, gdy brak klucza jest oczekiwany.
Wersja: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Składnia
try { var value = dictionary[key]; }
catch (System.Collections.Generic.KeyNotFoundException) { /* Handle the missing key. */ }System.Collections.Generic.KeyNotFoundException to typ wyjątku sygnalizujący próbę pobrania elementu kolekcji za pomocą klucza, którego w niej nie ma. Typ jest dostępny w .NET 10; korzystanie z niego nie wymaga funkcji języka w wersji preview.
W Dictionary<TKey,TValue> odczyt dictionary[key] zgłasza ten wyjątek, jeśli klucz nie istnieje. Zapis dictionary[key] = value zachowuje się inaczej: dodaje brakujący klucz albo zastępuje wartość istniejącego klucza. Brak klucza nie oznacza więc, że każda operacja indeksatora zgłosi wyjątek.
Gdy brak klucza jest oczekiwany, użyj TryGetValue(key, out value) zamiast sterować zwykłym przepływem programu za pomocą try/catch. Metoda zwraca false i przypisuje default(TValue) do parametru wyjściowego, jeśli klucza nie ma. Dla int jest to 0; sprawdzaj wynik logiczny, ponieważ 0 może też być prawidłowo zapisaną wartością.
Przykład celowo wywołuje i przechwytuje KeyNotFoundException, następnie pokazuje TryGetValue i dodanie brakującego klucza przez zapis. Blok catch wypisuje stały tekst, a nie systemowy komunikat wyjątku, dzięki czemu oczekiwany wynik nie zależy od języka komunikatów środowiska.
Przykłady
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"]);
}
}Wynik
Missing key: Lin Not found; out value: 0 20
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.