Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori