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

CKTIS / C#

IReadOnlyDictionary<TKey, TValue> — un dictionnaire exposé en lecture

IReadOnlyDictionary<TKey, TValue> permet de lire des paires clé-valeur sans proposer d’opérations de modification. Il ne garantit pas que les données soient immuables. Découvrez les options de recherche et CollectionExtensions.GetValueOrDefault.

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

Syntaxe

IReadOnlyDictionary<TKey, TValue> view = dictionary;
TValue value = view[key];
bool found = view.TryGetValue(key, out TValue result);
TValue fallback = view.GetValueOrDefault(key, defaultValue);

IReadOnlyDictionary<TKey, TValue> de System.Collections.Generic décrit l’accès à des paires dont les clés sont uniques. Il expose Count, Keys, Values, un indexeur, ContainsKey et TryGetValue. L’itération fournit des KeyValuePair<TKey, TValue> ; l’interface ne définit aucun ordre.

Lecture seule ne signifie pas immuable. L’interface n’expose aucune opération de modification, mais un Dictionary<TKey, TValue> sous-jacent peut changer par l’intermédiaire d’une autre référence. L’affecter à l’interface ne crée ni copie ni instantané, et ne fige pas les objets stockés comme valeurs.

Lorsqu’une clé peut être absente, utilisez TryGetValue(key, out value) : son résultat bool permet de distinguer une entrée absente d’une valeur par défaut enregistrée. CollectionExtensions.GetValueOrDefault est une méthode d’extension, et non un membre de l’interface. Pour utiliser la syntaxe des méthodes d’extension, la méthode doit être dans la portée au point d’appel, par exemple si le code appelant se trouve dans l’espace de noms System.Collections.Generic ou si cet espace de noms est importé avec using System.Collections.Generic; ou global using System.Collections.Generic;. Pour une clé absente, GetValueOrDefault(key) renvoie default(TValue), tandis que GetValueOrDefault(key, defaultValue) renvoie la valeur de remplacement fournie. Aucune des deux surcharges n’ajoute d’entrée ; un dictionnaire null provoque ArgumentNullException.

L’exemple .NET 10 présente les deux surcharges, la détection d’une entrée existante contenant 0 et la visibilité d’une modification ultérieure du dictionnaire sous-jacent. Il ne nécessite aucune fonctionnalité de langage en préversion.

Exemples

using System;
using System.Collections.Generic;

var stock = new Dictionary<string, int>
{
    ["pen"] = 3,
    ["paper"] = 0
};
IReadOnlyDictionary<string, int> view = stock;

Console.WriteLine(view["pen"]);
Console.WriteLine(view.GetValueOrDefault("eraser"));
Console.WriteLine(view.GetValueOrDefault("eraser", -1));
Console.WriteLine(view.TryGetValue("paper", out int count));
Console.WriteLine(count);

stock["pen"] = 5;
Console.WriteLine(view["pen"]);

Résultat

3
0
-1
True
0
5

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