База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници