CKTIS / C#
KeyValuePair<TKey,TValue> — un par clave-valor
KeyValuePair<TKey,TValue> contiene una clave y un valor de los tipos especificados. Sus propiedades Key y Value son de solo lectura. Encontrarás este tipo, por ejemplo, al recorrer un Dictionary<TKey,TValue>.
Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxis
new KeyValuePair<TKey,TValue>(key, value)
pair.Key
pair.ValueKeyValuePair<TKey,TValue> es una estructura del espacio de nombres System.Collections.Generic. Representa un único par, no un diccionario completo. TKey especifica el tipo de la clave y TValue, el tipo del valor. Al recorrer un Dictionary<TKey,TValue>, los elementos que se obtienen son de este tipo de par.
El constructor new KeyValuePair<TKey,TValue>(key, value) acepta una clave y un valor. Puedes leerlos mediante Key y Value. Ambas propiedades solo tienen un descriptor de acceso get, por lo que asignar pair.Value = 4 provoca un error de compilación.
Para reemplazar el par almacenado en una variable, asigna una instancia nueva a esa variable. Esto es distinto de cambiar una propiedad del par existente. En el ejemplo, la segunda asignación reemplaza el par completo y conserva la misma clave.
Esta explicación y el ejemplo cubren API disponibles en .NET 10. La configuración del proyecto LangVersion=preview no significa que el tipo en sí sea una característica experimental del lenguaje.
Ejemplos
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}");
}
}Resultado
apples: 3 apples: 4
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.