Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C#

IReadOnlyDictionary<TKey, TValue> — slovník sprístupnený na čítanie

IReadOnlyDictionary<TKey, TValue> sprístupňuje čítanie dvojíc kľúč–hodnota bez operácií na zmenu. Nezaručuje nemennosť údajov. Spoznajte možnosti vyhľadávania a metódu CollectionExtensions.GetValueOrDefault.

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

Syntax

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 opisuje prístup k dvojiciam s jedinečnými kľúčmi. Sprístupňuje Count, Keys, Values, indexer, ContainsKey a TryGetValue. Iterácia vracia KeyValuePair<TKey, TValue>; rozhranie neurčuje poradie.

Iba na čítanie neznamená nemenné. Rozhranie nesprístupňuje operácie na zmenu, no podkladový Dictionary<TKey, TValue> možno zmeniť cez inú referenciu. Priradením k rozhraniu nevznikne kópia ani snímka a nezmrazia sa ani objekty uložené ako hodnoty.

Ak kľúč nemusí existovať, použite TryGetValue(key, out value): jeho výsledok bool rozlišuje chýbajúcu položku od uloženej predvolenej hodnoty. CollectionExtensions.GetValueOrDefault je rozširujúca metóda, nie člen rozhrania. Pri použití syntaxe rozširujúcej metódy musí byť metóda v mieste volania v dosahu, napríklad ak sa volajúci kód nachádza v priestore názvov System.Collections.Generic alebo ak je tento priestor názvov importovaný pomocou using System.Collections.Generic; či global using System.Collections.Generic;. Ak kľúč chýba, GetValueOrDefault(key) vráti default(TValue), zatiaľ čo GetValueOrDefault(key, defaultValue) vráti zadanú náhradnú hodnotu. Ani jedno preťaženie položku nepridá; pri slovníku null sa vyvolá ArgumentNullException.

Príklad pre .NET 10 ukazuje obe preťaženia, rozpoznanie existujúcej položky s hodnotou 0 a viditeľnosť neskoršej zmeny podkladového slovníka. Nepotrebuje žiadne jazykové funkcie vo verzii preview.

Prí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ýsledok

3
0
-1
True
0
5

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje