CKTIS / C#
KeyNotFoundException — una chiave mancante in una raccolta
System.Collections.Generic.KeyNotFoundException segnala un tentativo di recuperare un elemento usando una chiave inesistente. Scopri la differenza tra letture e scritture con l’indicizzatore di Dictionary<TKey,TValue> e quando usare TryGetValue se è prevista una chiave mancante.
Versione: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintassi
try { var value = dictionary[key]; }
catch (System.Collections.Generic.KeyNotFoundException) { /* Handle the missing key. */ }System.Collections.Generic.KeyNotFoundException è un tipo di eccezione che segnala un tentativo di recuperare un elemento di una raccolta usando una chiave che la raccolta non contiene. Il tipo è disponibile in .NET 10; per usarlo non sono necessarie funzionalità del linguaggio in versione preview.
Per Dictionary<TKey,TValue>, la lettura di dictionary[key] genera questa eccezione se la chiave non esiste. La scrittura di dictionary[key] = value si comporta diversamente: aggiunge una chiave mancante oppure sostituisce il valore di una chiave esistente. Quindi, una chiave mancante non significa che ogni operazione con l’indicizzatore generi un’eccezione.
Quando è previsto che una chiave manchi, usa TryGetValue(key, out value) invece di ricorrere a try/catch per il normale flusso di controllo. Se la chiave è assente, il metodo restituisce false e assegna default(TValue) al parametro di output. Per int questo valore è 0; controlla il risultato booleano, perché 0 può anche essere un valore memorizzato legittimamente.
L’esempio genera e intercetta intenzionalmente KeyNotFoundException, poi mostra TryGetValue e l’aggiunta della chiave mancante tramite assegnazione. Il blocco catch stampa un testo fisso invece del messaggio di sistema dell’eccezione, così l’output previsto non dipende dalla lingua dei messaggi dell’ambiente di esecuzione.
Esempi
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"]);
}
}Risultato
Missing key: Lin Not found; out value: 0 20
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.