CKTIS / C#
IReadOnlyDictionary<TKey, TValue> — slovar, izpostavljen za branje
IReadOnlyDictionary<TKey, TValue> omogoča branje parov ključ–vrednost brez operacij za spreminjanje. Ne zagotavlja nespremenljivosti podatkov. Spoznajte možnosti iskanja in metodo CollectionExtensions.GetValueOrDefault.
Različica: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
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> iz System.Collections.Generic opisuje dostop do parov z enoličnimi ključi. Izpostavlja Count, Keys, Values, indeksator, ContainsKey in TryGetValue. Iteracija vrne KeyValuePair<TKey, TValue>; vmesnik ne določa vrstnega reda.
Samo za branje ne pomeni nespremenljivo. Vmesnik ne izpostavlja operacij za spreminjanje, vendar je mogoče osnovni Dictionary<TKey, TValue> spremeniti prek druge reference. Dodelitev vmesniku ne ustvari kopije ali posnetka in ne zamrzne objektov, shranjenih kot vrednosti.
Če ključ morda ne obstaja, uporabite TryGetValue(key, out value): rezultat bool razlikuje manjkajoči vnos od shranjene privzete vrednosti. CollectionExtensions.GetValueOrDefault je razširitvena metoda, ne član vmesnika. Za uporabo sintakse razširitvenih metod mora biti metoda v dosegu na mestu klica, na primer če je klicna koda v imenskem prostoru System.Collections.Generic ali če je ta imenski prostor uvožen z using System.Collections.Generic; ali global using System.Collections.Generic;. Če ključa ni, GetValueOrDefault(key) vrne default(TValue), medtem ko GetValueOrDefault(key, defaultValue) vrne navedeno nadomestno vrednost. Nobena od preobremenitev ne doda vnosa; pri slovarju null se sproži ArgumentNullException.
Primer za .NET 10 prikazuje obe preobremenitvi, zaznavanje obstoječega vnosa z vrednostjo 0 in vidnost poznejše spremembe osnovnega slovarja. Ne zahteva jezikovnih funkcij v predogledni različici.
Primeri
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"]);Rezultat
3 0 -1 True 0 5
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.