Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

IReadOnlyDictionary<TKey, TValue> — un dizionario esposto in lettura

IReadOnlyDictionary<TKey, TValue> consente di leggere coppie chiave-valore senza offrire operazioni di modifica. Non garantisce che i dati siano immutabili. Scopri le opzioni di ricerca e CollectionExtensions.GetValueOrDefault.

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

Sintassi

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> di System.Collections.Generic descrive l’accesso a coppie con chiavi univoche. Espone Count, Keys, Values, un indicizzatore, ContainsKey e TryGetValue. L’iterazione restituisce KeyValuePair<TKey, TValue>; l’interfaccia non definisce un ordine.

Sola lettura non significa immutabile. L’interfaccia non espone operazioni di modifica, ma un Dictionary<TKey, TValue> sottostante può cambiare tramite un altro riferimento. Assegnarlo all’interfaccia non crea né una copia né uno snapshot e non rende immutabili gli oggetti memorizzati come valori.

Quando una chiave potrebbe non esistere, usa TryGetValue(key, out value): il risultato bool distingue una voce mancante da un valore predefinito memorizzato. CollectionExtensions.GetValueOrDefault è un metodo di estensione, non un membro dell’interfaccia. Per usare la sintassi dei metodi di estensione, il metodo deve essere visibile nel punto della chiamata, ad esempio perché il codice chiamante si trova nello spazio dei nomi System.Collections.Generic o perché tale spazio dei nomi è importato con using System.Collections.Generic; o global using System.Collections.Generic;. Se la chiave manca, GetValueOrDefault(key) restituisce default(TValue), mentre GetValueOrDefault(key, defaultValue) restituisce il valore alternativo fornito. Nessuno dei due overload inserisce una voce; un dizionario null causa ArgumentNullException.

L’esempio .NET 10 mostra entrambi gli overload, il rilevamento di una voce esistente con valore 0 e la visibilità di una modifica successiva al dizionario sottostante. Non richiede funzionalità del linguaggio in versione preview.

Esempi

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

Risultato

3
0
-1
True
0
5

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.

Fonti