CKTIS / C#
KeyValuePair<TKey,TValue> — двойка ключ-стойност
KeyValuePair<TKey,TValue> съдържа един ключ и една стойност от зададените типове. Свойствата Key и Value са само за четене. Ще срещнете този тип например при обхождане на Dictionary<TKey,TValue>.
Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Синтаксис
new KeyValuePair<TKey,TValue>(key, value)
pair.Key
pair.ValueKeyValuePair<TKey,TValue> е структура в пространството от имена System.Collections.Generic. Тя представя една двойка, а не цял речник. TKey задава типа на ключа, а TValue — типа на стойността. При обхождане на Dictionary<TKey,TValue> получените елементи са именно от този тип двойка.
Конструкторът new KeyValuePair<TKey,TValue>(key, value) приема ключ и стойност. Можете да ги прочетете чрез Key и Value. И двете свойства имат само достъп чрез get, затова присвояването pair.Value = 4 води до грешка при компилиране.
За да замените двойката, съхранена в променлива, присвоете на тази променлива нов екземпляр. Това е различно от промяната на свойство на съществуващата двойка. В примера второто присвояване заменя цялата двойка, като запазва същия ключ.
Това обяснение и примерът разглеждат API, налични в .NET 10. Настройката на проекта LangVersion=preview не означава, че самият тип е експериментална езикова функция.
Примери
using System;
using System.Collections.Generic;
internal static class Program
{
private static void Main()
{
var pair = new KeyValuePair<string, int>("apples", 3);
Console.WriteLine($"{pair.Key}: {pair.Value}");
pair = new KeyValuePair<string, int>(pair.Key, 4);
Console.WriteLine($"{pair.Key}: {pair.Value}");
}
}Резултат
apples: 3 apples: 4
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.