Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

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

Fuentes