Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

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

Źródła