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