Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

KeyValuePair<TKey,TValue> — une paire clé-valeur

KeyValuePair<TKey,TValue> contient une clé et une valeur des types spécifiés. Ses propriétés Key et Value sont en lecture seule. Vous rencontrerez ce type, par exemple, en parcourant un Dictionary<TKey,TValue>.

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

Syntaxe

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

KeyValuePair<TKey,TValue> est une structure de l’espace de noms System.Collections.Generic. Elle représente une seule paire, et non un dictionnaire entier. TKey définit le type de la clé et TValue celui de la valeur. Lorsque vous parcourez un Dictionary<TKey,TValue>, les éléments obtenus sont de ce type de paire.

Le constructeur new KeyValuePair<TKey,TValue>(key, value) accepte une clé et une valeur. Vous pouvez les lire avec Key et Value. Ces deux propriétés ne possèdent qu’un accesseur get ; une affectation telle que pair.Value = 4 provoque donc une erreur de compilation.

Pour remplacer la paire stockée dans une variable, affectez une nouvelle instance à cette variable. Cela ne revient pas à modifier une propriété de la paire existante. Dans l’exemple, la deuxième affectation remplace la paire entière tout en conservant la même clé.

Cette explication et cet exemple portent sur des API disponibles dans .NET 10. Le paramètre de projet LangVersion=preview ne signifie pas que le type lui-même est une fonctionnalité expérimentale du langage.

Exemples

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

Résultat

apples: 3
apples: 4

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources