Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

KeyNotFoundException — une clé absente dans une collection

System.Collections.Generic.KeyNotFoundException signale une tentative de récupération d’un élément à l’aide d’une clé inexistante. Découvrez la différence entre les lectures et les écritures avec l’indexeur de Dictionary<TKey,TValue>, ainsi que le moment où utiliser TryGetValue lorsqu’une clé absente est attendue.

Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntaxe

try { var value = dictionary[key]; }
catch (System.Collections.Generic.KeyNotFoundException) { /* Handle the missing key. */ }

System.Collections.Generic.KeyNotFoundException est un type d’exception qui signale une tentative de récupération d’un élément d’une collection à l’aide d’une clé que celle-ci ne contient pas. Ce type est disponible dans .NET 10 ; son utilisation ne nécessite aucune fonctionnalité du langage en version preview.

Pour Dictionary<TKey,TValue>, la lecture de dictionary[key] déclenche cette exception si la clé n’existe pas. L’écriture dictionary[key] = value se comporte différemment : elle ajoute une clé absente ou remplace la valeur d’une clé existante. Une clé absente ne signifie donc pas que toute opération avec l’indexeur déclenche une exception.

Lorsqu’une clé absente est attendue, utilisez TryGetValue(key, out value) au lieu de recourir à try/catch pour le déroulement normal du programme. La méthode renvoie false et affecte default(TValue) au paramètre de sortie si la clé est absente. Pour int, il s’agit de 0 ; vérifiez le résultat booléen, car 0 peut aussi être une valeur stockée légitimement.

L’exemple déclenche volontairement KeyNotFoundException et l’intercepte, puis montre TryGetValue et l’ajout de la clé absente par affectation. Le bloc catch affiche un texte fixe plutôt que le message système de l’exception, afin que la sortie attendue ne dépende pas de la langue des messages de l’environnement d’exécution.

Exemples

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"]);
    }
}

Résultat

Missing key: Lin
Not found; out value: 0
20

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources