Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

KeyValuePair<TKey,TValue> — una coppia chiave-valore

KeyValuePair<TKey,TValue> contiene una chiave e un valore dei tipi specificati. Le proprietà Key e Value sono di sola lettura. Incontrerai questo tipo, ad esempio, quando iteri su un Dictionary<TKey,TValue>.

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

Sintassi

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

KeyValuePair<TKey,TValue> è una struttura nello spazio dei nomi System.Collections.Generic. Rappresenta una singola coppia, non un intero dizionario. TKey specifica il tipo della chiave e TValue quello del valore. Quando iteri su un Dictionary<TKey,TValue>, gli elementi ottenuti sono di questo tipo di coppia.

Il costruttore new KeyValuePair<TKey,TValue>(key, value) accetta una chiave e un valore. Puoi leggerli tramite Key e Value. Entrambe le proprietà hanno soltanto un accessore get, quindi assegnare pair.Value = 4 causa un errore di compilazione.

Per sostituire la coppia contenuta in una variabile, assegna una nuova istanza a quella variabile. È diverso dal modificare una proprietà della coppia esistente. Nell’esempio, la seconda assegnazione sostituisce l’intera coppia mantenendo la stessa chiave.

Questa spiegazione e l’esempio riguardano API disponibili in .NET 10. L’impostazione del progetto LangVersion=preview non significa che il tipo stesso sia una funzionalità sperimentale del linguaggio.

Esempi

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

Risultato

apples: 3
apples: 4

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti