CKTIS / C#
KeyValuePair<TKey,TValue> — een sleutel-waarde-paar
KeyValuePair<TKey,TValue> bevat één sleutel en één waarde van de opgegeven typen. De eigenschappen Key en Value zijn alleen-lezen. Je komt dit type bijvoorbeeld tegen wanneer je een Dictionary<TKey,TValue> doorloopt.
Versie: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
new KeyValuePair<TKey,TValue>(key, value)
pair.Key
pair.ValueKeyValuePair<TKey,TValue> is een structuur in de naamruimte System.Collections.Generic. Het stelt één paar voor, niet een volledige dictionary. TKey geeft het sleuteltype aan en TValue het waardetype. Wanneer je een Dictionary<TKey,TValue> doorloopt, zijn de elementen van dit paar-type.
De constructor new KeyValuePair<TKey,TValue>(key, value) accepteert een sleutel en een waarde. Je leest ze uit via Key en Value. Beide eigenschappen hebben alleen een get-accessor, dus een toewijzing zoals pair.Value = 4 veroorzaakt een compileerfout.
Als je het paar in een variabele wilt vervangen, wijs je een nieuwe instantie aan die variabele toe. Dat is iets anders dan een eigenschap van het bestaande paar wijzigen. In het voorbeeld vervangt de tweede toewijzing het volledige paar, terwijl dezelfde sleutel behouden blijft.
Deze uitleg en dit voorbeeld gaan over API’s die beschikbaar zijn in .NET 10. De projectinstelling LangVersion=preview betekent niet dat het type zelf een experimentele taalfunctie is.
Voorbeelden
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}");
}
}Resultaat
apples: 3 apples: 4
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.