CKTIS / C#
KeyNotFoundException — una clave ausente en una colección
System.Collections.Generic.KeyNotFoundException indica un intento de recuperar un elemento mediante una clave que no existe. Aprende en qué se diferencian las lecturas y escrituras del indizador de Dictionary<TKey,TValue> y cuándo usar TryGetValue si se espera que falte una clave.
Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxis
try { var value = dictionary[key]; }
catch (System.Collections.Generic.KeyNotFoundException) { /* Handle the missing key. */ }System.Collections.Generic.KeyNotFoundException es un tipo de excepción que indica un intento de recuperar un elemento de una colección mediante una clave que esta no contiene. El tipo está disponible en .NET 10; usarlo no requiere características del lenguaje en versión preview.
En Dictionary<TKey,TValue>, leer dictionary[key] produce esta excepción si la clave no existe. Escribir dictionary[key] = value se comporta de otra manera: agrega una clave ausente o reemplaza el valor de una clave existente. Por tanto, que falte una clave no significa que toda operación con el indizador produzca una excepción.
Cuando se espera que falte una clave, usa TryGetValue(key, out value) en lugar de utilizar try/catch para el flujo de control habitual. El método devuelve false y asigna default(TValue) al parámetro de salida si la clave está ausente. Para int, este valor es 0; comprueba el resultado booleano, porque 0 también puede ser un valor almacenado válido.
El ejemplo provoca y captura deliberadamente KeyNotFoundException; después muestra TryGetValue y cómo agregar la clave ausente mediante una asignación. El bloque catch imprime un texto fijo en vez del mensaje de excepción del sistema, de modo que la salida esperada no depende del idioma de los mensajes del entorno de ejecución.
Ejemplos
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"]);
}
}Resultado
Missing key: Lin Not found; out value: 0 20
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.