CKTIS / C#
IReadOnlyDictionary<TKey, TValue> — slovník zpřístupněný pro čtení
IReadOnlyDictionary<TKey, TValue> zpřístupňuje čtení dvojic klíč–hodnota bez operací pro změnu. Nezaručuje neměnnost dat. Seznamte se s možnostmi vyhledávání a metodou CollectionExtensions.GetValueOrDefault.
Verze: .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> z System.Collections.Generic popisuje přístup k dvojicím s jedinečnými klíči. Zpřístupňuje Count, Keys, Values, indexer, ContainsKey a TryGetValue. Iterace vrací KeyValuePair<TKey, TValue>; rozhraní neurčuje pořadí.
Jen pro čtení neznamená neměnné. Rozhraní nezpřístupňuje operace pro změnu, ale podkladový Dictionary<TKey, TValue> lze změnit přes jinou referenci. Přiřazením k rozhraní nevznikne kopie ani snímek a nezmrazí se ani objekty uložené jako hodnoty.
Pokud klíč nemusí existovat, použijte TryGetValue(key, out value): jeho výsledek bool rozlišuje chybějící položku od uložené výchozí hodnoty. CollectionExtensions.GetValueOrDefault je rozšiřující metoda, nikoli člen rozhraní. Chcete-li použít syntaxi rozšiřující metody, musí být metoda v místě volání v dosahu, například pokud se volající kód nachází v oboru názvů System.Collections.Generic nebo je tento obor názvů importován pomocí using System.Collections.Generic; či global using System.Collections.Generic;. Pokud klíč chybí, GetValueOrDefault(key) vrátí default(TValue), zatímco GetValueOrDefault(key, defaultValue) vrátí zadanou náhradní hodnotu. Žádné z přetížení položku nepřidá; pro slovník null se vyvolá ArgumentNullException.
Příklad pro .NET 10 ukazuje obě přetížení, rozpoznání existující položky s hodnotou 0 a viditelnost pozdější změny podkladového slovníku. Nepotřebuje žádné jazykové funkce ve verzi preview.
Příklady
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"]);Výsledek
3 0 -1 True 0 5
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.