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