CKTIS / C#
IReadOnlyDictionary<TKey, TValue> — rječnik izložen za čitanje
IReadOnlyDictionary<TKey, TValue> omogućuje čitanje parova ključ-vrijednost bez operacija izmjene. Ne jamči da su podaci nepromjenjivi. Saznajte više o pretraživanju i metodi CollectionExtensions.GetValueOrDefault.
Verzija: .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 pristup parovima s jedinstvenim ključevima. Izlaže Count, Keys, Values, indeksator, ContainsKey i TryGetValue. Iteracija vraća KeyValuePair<TKey, TValue>; sučelje ne određuje redoslijed.
Samo za čitanje ne znači nepromjenjivo. Sučelje ne izlaže operacije izmjene, ali temeljni Dictionary<TKey, TValue> može se promijeniti putem druge reference. Dodjela sučelju ne stvara kopiju ni snimku i ne zamrzava objekte pohranjene kao vrijednosti.
Ako ključ možda ne postoji, upotrijebite TryGetValue(key, out value): rezultat bool razlikuje nedostajući unos od pohranjene zadane vrijednosti. CollectionExtensions.GetValueOrDefault metoda je proširenja, a ne član sučelja. Za uporabu sintakse metoda proširenja metoda mora biti u dosegu na mjestu poziva, primjerice ako se kôd koji je poziva nalazi u imenskom prostoru System.Collections.Generic ili ako je taj imenski prostor uvezen direktivom using System.Collections.Generic; ili global using System.Collections.Generic;. Ako ključ nedostaje, GetValueOrDefault(key) vraća default(TValue), dok GetValueOrDefault(key, defaultValue) vraća navedenu zamjensku vrijednost. Nijedno preopterećenje ne dodaje unos; za rječnik null izbacuje se ArgumentNullException.
Primjer za .NET 10 prikazuje oba preopterećenja, prepoznavanje postojećeg unosa s vrijednošću 0 i vidljivost kasnije promjene temeljnog rječnika. Ne zahtijeva jezične značajke pretpregledne verzije.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.