Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

KeyValuePair<TKey,TValue> — dvojice klíč-hodnota

KeyValuePair<TKey,TValue> uchovává jeden klíč a jednu hodnotu zadaných typů. Vlastnosti Key a Value jsou pouze pro čtení. S tímto typem se setkáte například při procházení Dictionary<TKey,TValue>.

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

Syntaxe

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

KeyValuePair<TKey,TValue> je struktura v oboru názvů System.Collections.Generic. Představuje jednu dvojici, nikoli celý slovník. TKey určuje typ klíče a TValue typ hodnoty. Při procházení Dictionary<TKey,TValue> jsou získané prvky právě tohoto párového typu.

Konstruktor new KeyValuePair<TKey,TValue>(key, value) přijímá klíč a hodnotu. Přečtete je prostřednictvím Key a Value. Obě vlastnosti mají pouze přístupový člen get, takže přiřazení pair.Value = 4 způsobí chybu kompilace.

Chcete-li nahradit dvojici uloženou v proměnné, přiřaďte této proměnné novou instanci. To se liší od změny vlastnosti existující dvojice. V příkladu druhé přiřazení nahradí celou dvojici a zachová přitom stejný klíč.

Tento popis a příklad se týkají API dostupných v .NET 10. Nastavení projektu LangVersion=preview neznamená, že samotný typ je experimentální jazyková funkce.

Pří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ýsledek

apples: 3
apples: 4

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje