Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła