Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes