WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

KeyValuePair<TKey,TValue> — ein Schlüssel-Wert-Paar

KeyValuePair<TKey,TValue> enthält einen Schlüssel und einen Wert der angegebenen Typen. Die Eigenschaften Key und Value sind schreibgeschützt. Dieser Typ begegnet Ihnen beispielsweise beim Durchlaufen eines Dictionary<TKey,TValue>.

Version: .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> ist eine Struktur im Namespace System.Collections.Generic. Sie stellt ein einzelnes Paar dar, nicht ein ganzes Wörterbuch. TKey legt den Typ des Schlüssels fest, TValue den Typ des Werts. Beim Durchlaufen eines Dictionary<TKey,TValue> erhalten Sie Elemente dieses Paartyps.

Der Konstruktor new KeyValuePair<TKey,TValue>(key, value) nimmt einen Schlüssel und einen Wert entgegen. Sie können sie über Key und Value auslesen. Beide Eigenschaften besitzen nur einen get-Accessor. Daher führt eine Zuweisung wie pair.Value = 4 zu einem Kompilierfehler.

Um das in einer Variablen gespeicherte Paar zu ersetzen, weisen Sie der Variablen eine neue Instanz zu. Das ist etwas anderes, als eine Eigenschaft des vorhandenen Paars zu ändern. Im Beispiel ersetzt die zweite Zuweisung das gesamte Paar, wobei derselbe Schlüssel erhalten bleibt.

Diese Erläuterung und das Beispiel behandeln APIs, die in .NET 10 verfügbar sind. Die Projekteinstellung LangVersion=preview bedeutet nicht, dass der Typ selbst ein experimentelles Sprachfeature ist.

Beispiele

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

Ergebnis

apples: 3
apples: 4

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen