System.Collections.Generic.KeyNotFoundException: The given key 'pere' was not present in the dictionary.
Ai citit dintr-un `Dictionary` o cheie care nu există (`stoc["pere"]`). Verifică înainte cu `TryGetValue(cheie, out var valoare)` sau `ContainsKey`, ori folosește `GetValueOrDefault(cheie)`.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Indexatorul unui dicționar, dictionar[cheie], are două comportamente diferite. La scriere (stoc["pere"] = 5;) adaugă cheia dacă lipsește sau o suprascrie. La citire (int x = stoc["pere"];), dacă cheia nu există, aruncă KeyNotFoundException. Mesajul din .NET modern include cheia căutată: „The given key 'pere' was not present in the dictionary.”
Stack trace-ul arată Dictionary2.get_Item(TKey key)`, adică citirea prin indexator, și linia ta.
Cauzele obișnuite: cheia chiar lipsește (un produs nou, un cuvânt văzut prima dată); cheia diferă prin litere mari sau mici ("Mere" vs "mere"), pentru că dicționarul compară implicit exact; spații în plus ("mere "); sau tipul cheii diferă (cheia "1" vs 1). Un caz clasic este numărarea frecvențelor cu frecv[cuvant]++, care la primul cuvânt nou citește o cheie inexistentă.
Pentru citiri în care cheia poate lipsi, TryGetValue face o singură căutare și nu aruncă excepție.
De ce apare: cauzele frecvente
1Citirea unei chei care lipsește
var stoc = new Dictionary<string, int> { ["mere"] = 10 };
Console.WriteLine(stoc["pere"]);var stoc = new Dictionary<string, int> { ["mere"] = 10 };
if (stoc.TryGetValue("pere", out int cant))
Console.WriteLine(cant);
else
Console.WriteLine("pere: nu exista in stoc");TryGetValue întoarce false pentru chei lipsă, fără excepție.
2Numărare cu ++ pe chei noi
var frecv = new Dictionary<string, int>();
foreach (var c in new[] { "a", "b", "a" })
frecv[c]++;var frecv = new Dictionary<string, int>();
foreach (var c in new[] { "a", "b", "a" })
frecv[c] = frecv.GetValueOrDefault(c) + 1;frecv[c]++ citește întâi valoarea, care nu există la prima apariție. GetValueOrDefault dă 0 pentru chei noi.
3Litere mari diferite
var preturi = new Dictionary<string, decimal> { ["Pix"] = 3m };
Console.WriteLine(preturi["pix"]);var preturi = new Dictionary<string, decimal>(StringComparer.OrdinalIgnoreCase) { ["Pix"] = 3m };
Console.WriteLine(preturi["pix"]);Cu StringComparer.OrdinalIgnoreCase, dicționarul tratează „Pix” și „pix” ca aceeași cheie.
Repară eroarea, direct în pagină
Programul numără de câte ori apare fiecare categorie în lista de comenzi, dar la rulare primești System.Collections.Generic.KeyNotFoundException: The given key 'carti' was not present in the dictionary. Repară numărarea, astfel încât programul să afișeze fiecare categorie cu numărul ei de comenzi.
string[] comenzi = { "carti", "jucarii", "carti", "electronice", "carti", "jucarii" };
var numar = new Dictionary<string, int>();
foreach (string c in comenzi)
numar[c]++;
foreach (var (categorie, n) in numar)
Console.WriteLine($"{categorie}: {n}");carti: 3 jucarii: 2 electronice: 1
Indiciu
Pentru o categorie nouă, valoarea curentă trebuie considerată 0: GetValueOrDefault(c) + 1.
Reparația
string[] comenzi = { "carti", "jucarii", "carti", "electronice", "carti", "jucarii" };
var numar = new Dictionary<string, int>();
foreach (string c in comenzi)
numar[c] = numar.GetValueOrDefault(c) + 1;
foreach (var (categorie, n) in numar)
Console.WriteLine($"{categorie}: {n}");De ce merge
numar[c]++ înseamnă „citește numar[c], adună 1 și scrie la loc”. La prima apariție a categoriei „carti”, cheia nu există încă, deci citirea arunca KeyNotFoundException. GetValueOrDefault(c) întoarce 0 pentru o cheie lipsă și valoarea existentă altfel, iar atribuirea prin indexator adaugă sau actualizează cheia. Dicționarul păstrează ordinea în care au fost adăugate cheile, deci afișarea urmează ordinea primei apariții.
Alte forme ale mesajului
System.Collections.Generic.KeyNotFoundException: The given key was not present in the dictionary.
Cum o eviți pe viitor
- Folosește indexatorul la citire doar când ești sigur că cheia există; altfel
TryGetValuesauGetValueOrDefault. - Normalizează cheile la inserare și la căutare (
Trim(),ToLower()) sau folosește un comparator care ignoră literele mari. - Pentru numărări, folosește
GetValueOrDefault(cheie) + 1sauCollectionsMarshal/LINQGroupBy. - Afișează cheile existente (
string.Join(", ", d.Keys)) când depanezi o cheie „care ar trebui să existe”.
Întrebări frecvente
De ce stoc["pere"] = 5; nu aruncă excepție, dar citirea da?
La scriere, indexatorul adaugă cheia dacă nu există. La citire nu are ce valoare să întoarcă, așa că aruncă KeyNotFoundException.
ContainsKey + indexator sau TryGetValue?
Ambele sunt corecte, dar TryGetValue face o singură căutare în loc de două și scrie valoarea direct în variabila out. E varianta recomandată.
În tutoriale mesajul nu conține cheia. De ce?
În versiunile vechi .NET Framework, mesajul era „The given key was not present in the dictionary.” fără cheie. .NET Core 3.0 și mai nou adaugă cheia în mesaj.
Erori înrudite
System.ArgumentException: An item with the same key has already been added. Key: mere Ai apelat `Add` pe un `Dictionary` cu o cheie care există deja. Dacă vrei să actualizezi valoarea, folosește indexatorul (`stoc["mere"] = 5;`); dacă vrei să adaugi doar când lipsește, folosește `TryAdd` sau verifică `ContainsKey`. System.NullReferenceException: Object reference not set to an instance of an object. Ai folosit un membru (`.Length`, `.Nume`, o metodă) pe o variabilă care are valoarea `null`, adică nu indică spre niciun obiect. Găsește pe linia din stack trace ce variabilă e `null` și fie îi dai un obiect (`new ...`), fie verifici înainte (`if (x != null)`, `x?.Length`, `x ?? "implicit"`). System.ArgumentOutOfRangeException: Index was out of range. Must be non-negative and less than the size of the collection. (Parameter 'index') Ai accesat într-o listă (`List<T>`) un indice care nu există: negativ sau mai mare ori egal cu `Count`. Indicii valizi sunt de la 0 la `Count - 1`; verifică bucla (`i < lista.Count`) și dacă lista are elementele la care te aștepți. Învață C# de la zero, cu exerciții la fiecare lecție
Curs C#: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
