CKTIS / C#
KeyValuePair<TKey,TValue> — par ključ-vrednost
KeyValuePair<TKey,TValue> vsebuje en ključ in eno vrednost navedenih tipov. Lastnosti Key in Value sta samo za branje. S tem tipom se srečate na primer pri iteriranju po Dictionary<TKey,TValue>.
Različica: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
new KeyValuePair<TKey,TValue>(key, value)
pair.Key
pair.ValueKeyValuePair<TKey,TValue> je struktura v imenskem prostoru System.Collections.Generic. Predstavlja en par, ne celotnega slovarja. TKey določa tip ključa, TValue pa tip vrednosti. Pri iteriranju po Dictionary<TKey,TValue> so pridobljeni elementi prav tega parnega tipa.
Konstruktor new KeyValuePair<TKey,TValue>(key, value) sprejme ključ in vrednost. Preberete ju prek Key in Value. Obe lastnosti imata samo dostopnik get, zato dodelitev pair.Value = 4 povzroči napako pri prevajanju.
Če želite zamenjati par, shranjen v spremenljivki, tej spremenljivki dodelite nov primerek. To se razlikuje od spreminjanja lastnosti obstoječega para. V primeru druga dodelitev zamenja celoten par, pri tem pa ohrani isti ključ.
Ta razlaga in primer obravnavata API-je, ki so na voljo v .NET 10. Nastavitev projekta LangVersion=preview ne pomeni, da je sam tip eksperimentalna jezikovna funkcija.
Primeri
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}");
}
}Rezultat
apples: 3 apples: 4
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.