CKTIS / C#
IReadOnlyDictionary<TKey, TValue> — речник, предоставен за четене
IReadOnlyDictionary<TKey, TValue> предоставя достъп за четене до двойки ключ–стойност без операции за промяна. Не гарантира неизменност на данните. Научете за начините за търсене и CollectionExtensions.GetValueOrDefault.
Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Синтаксис
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> от System.Collections.Generic описва достъп до двойки с уникални ключове. Предоставя Count, Keys, Values, индексатор, ContainsKey и TryGetValue. Итерацията връща KeyValuePair<TKey, TValue>; интерфейсът не задава ред.
Само за четене не означава неизменяемо. Интерфейсът не предоставя операции за промяна, но базовият Dictionary<TKey, TValue> може да се променя чрез друга референция. Присвояването му към интерфейса не създава копие или моментна снимка и не замразява обектите, съхранявани като стойности.
Когато даден ключ може да липсва, използвайте TryGetValue(key, out value): резултатът bool различава липсващ запис от съхранена стойност по подразбиране. CollectionExtensions.GetValueOrDefault е метод за разширение, а не член на интерфейса. За да се използва синтаксисът за методи за разширение, методът трябва да е в обхвата на мястото на извикване, например когато извикващият код е в пространството от имена System.Collections.Generic или когато това пространство от имена е импортирано с using System.Collections.Generic; или global using System.Collections.Generic;. При липсващ ключ GetValueOrDefault(key) връща default(TValue), а GetValueOrDefault(key, defaultValue) връща зададената резервна стойност. Нито едно претоварване не добавя запис; при речник null се хвърля ArgumentNullException.
Примерът за .NET 10 показва и двете претоварвания, откриването на съществуващ запис със стойност 0 и видимостта на последваща промяна в базовия речник. Не са необходими езикови функции от предварителна версия.
Примери
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"]);Резултат
3 0 -1 True 0 5
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.