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

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.Value

KeyValuePair<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

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

Източници