CKTIS / C#
IReadOnlyDictionary<TKey, TValue> — słownik udostępniony do odczytu
IReadOnlyDictionary<TKey, TValue> udostępnia odczyt par klucz–wartość bez operacji modyfikujących. Nie gwarantuje niezmienności danych. Poznaj wyszukiwanie oraz CollectionExtensions.GetValueOrDefault.
Wersja: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Składnia
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 dostęp do par o unikatowych kluczach. Udostępnia Count, Keys, Values, indeksator, ContainsKey i TryGetValue. Iteracja zwraca KeyValuePair<TKey, TValue>; interfejs nie określa kolejności.
Tylko do odczytu nie oznacza niezmienny. Interfejs nie udostępnia operacji modyfikacji, ale bazowy Dictionary<TKey, TValue> może zmieniać się przez inną referencję. Samo przypisanie do interfejsu nie tworzy kopii ani migawki i nie zamraża obiektów będących wartościami.
Gdy klucz może nie istnieć, użyj TryGetValue(key, out value): wynik bool odróżnia brak wpisu od zapisanej wartości domyślnej. CollectionExtensions.GetValueOrDefault jest metodą rozszerzającą, a nie składową interfejsu. Aby użyć składni metody rozszerzającej, metoda musi być w zasięgu w miejscu wywołania, na przykład gdy kod wywołujący znajduje się w przestrzeni nazw System.Collections.Generic lub gdy zaimportowano tę przestrzeń nazw dyrektywą using System.Collections.Generic; albo global using System.Collections.Generic;. GetValueOrDefault(key) zwraca przy braku klucza default(TValue), a GetValueOrDefault(key, defaultValue) — wskazaną wartość zastępczą. Żadne przeciążenie nie dodaje wpisu; dla null jako słownika zgłaszany jest ArgumentNullException.
Przykład dla .NET 10 pokazuje oba przeciążenia, rozpoznanie istniejącego wpisu o wartości 0 oraz widoczność późniejszej zmiany bazowego słownika. Nie wymaga funkcji języka w wersji preview.
Przykłady
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"]);Wynik
3 0 -1 True 0 5
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.