Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje