...
Eroare C# · Excepții cu tablouri, liste, dicționare și LINQ

System.Collections.Generic.KeyNotFoundException: The given key 'pere' was not present in the dictionary.

Pe scurt

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

Greșit
C#
var stoc = new Dictionary<string, int> { ["mere"] = 10 };
Console.WriteLine(stoc["pere"]);
Corect
C#
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

Greșit
C#
var frecv = new Dictionary<string, int>();
foreach (var c in new[] { "a", "b", "a" })
    frecv[c]++;
Corect
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

Greșit
C#
var preturi = new Dictionary<string, decimal> { ["Pix"] = 3m };
Console.WriteLine(preturi["pix"]);
Corect
C#
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ă tu

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.

Codul care dă eroarea
C#
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}");
După reparație, programul afișează
carti: 3
jucarii: 2
electronice: 1
Indiciu

Pentru o categorie nouă, valoarea curentă trebuie considerată 0: GetValueOrDefault(c) + 1.

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 TryGetValue sau GetValueOrDefault.
  • 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) + 1 sau CollectionsMarshal/LINQ GroupBy.
  • 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

← Toate erorile C#

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.