Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

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

Viri