Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C#

KeyValuePair<TKey,TValue> — dvojica kľúč-hodnota

KeyValuePair<TKey,TValue> uchováva jeden kľúč a jednu hodnotu zadaných typov. Vlastnosti Key a Value sú iba na čítanie. S týmto typom sa stretnete napríklad pri prechádzaní Dictionary<TKey,TValue>.

Verzia: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntax

new KeyValuePair<TKey,TValue>(key, value)
pair.Key
pair.Value

KeyValuePair<TKey,TValue> je štruktúra v mennom priestore System.Collections.Generic. Predstavuje jednu dvojicu, nie celý slovník. TKey určuje typ kľúča a TValue typ hodnoty. Pri prechádzaní Dictionary<TKey,TValue> sú získané prvky práve tohto párového typu.

Konštruktor new KeyValuePair<TKey,TValue>(key, value) prijíma kľúč a hodnotu. Prečítate ich cez Key a Value. Obe vlastnosti majú iba prístupový člen get, takže priradenie pair.Value = 4 spôsobí chybu kompilácie.

Ak chcete nahradiť dvojicu uloženú v premennej, priraďte tejto premennej novú inštanciu. Je to iné než zmeniť vlastnosť existujúcej dvojice. V príklade druhé priradenie nahradí celú dvojicu a zároveň zachová ten istý kľúč.

Tento opis a príklad sa týkajú API dostupných v .NET 10. Nastavenie projektu LangVersion=preview neznamená, že samotný typ je experimentálnou jazykovou funkciou.

Príklady

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}");
    }
}

Výsledok

apples: 3
apples: 4

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje