CKTIS / C#
KeyValuePair<TKey,TValue> — para klucz–wartość
KeyValuePair<TKey,TValue> przechowuje jeden klucz i jedną wartość określonych typów. Właściwości Key i Value służą wyłącznie do odczytu; typ ten spotkasz między innymi podczas iterowania po Dictionary<TKey,TValue>.
Wersja: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Składnia
new KeyValuePair<TKey,TValue>(key, value)
pair.Key
pair.ValueKeyValuePair<TKey,TValue> to struktura z przestrzeni nazw System.Collections.Generic. Reprezentuje pojedynczą parę, a nie cały słownik. TKey określa typ klucza, a TValue — typ wartości. Przy iterowaniu po Dictionary<TKey,TValue> elementami są właśnie takie pary.
Konstruktor new KeyValuePair<TKey,TValue>(key, value) przyjmuje klucz i wartość. Odczytuje się je przez Key i Value. Obie właściwości mają wyłącznie akcesor get, więc przypisanie pair.Value = 4 jest błędem kompilacji.
Aby zastąpić parę przechowywaną w zmiennej, przypisz tej zmiennej nową instancję. To inna operacja niż zmiana właściwości istniejącej pary. W przykładzie drugie przypisanie zastępuje całą parę, zachowując ten sam klucz.
Opis i przykład dotyczą API dostępnego w .NET 10. Ustawienie projektu LangVersion=preview nie oznacza, że sam typ jest funkcją eksperymentalną języka.
Przykłady
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}");
}
}Wynik
apples: 3 apples: 4
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.