Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

KeyValuePair<TKey,TValue> — um par chave-valor

KeyValuePair<TKey,TValue> contém uma chave e um valor dos tipos especificados. As propriedades Key e Value são só de leitura. Encontrará este tipo, por exemplo, ao percorrer um Dictionary<TKey,TValue>.

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

Sintaxe

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

KeyValuePair<TKey,TValue> é uma estrutura do espaço de nomes System.Collections.Generic. Representa um único par, não um dicionário inteiro. TKey especifica o tipo da chave e TValue o tipo do valor. Ao percorrer um Dictionary<TKey,TValue>, os elementos obtidos são deste tipo de par.

O construtor new KeyValuePair<TKey,TValue>(key, value) recebe uma chave e um valor. Pode lê-los através de Key e Value. Ambas as propriedades têm apenas um acessor get, pelo que atribuir pair.Value = 4 provoca um erro de compilação.

Para substituir o par guardado numa variável, atribua uma nova instância a essa variável. Isto é diferente de alterar uma propriedade do par existente. No exemplo, a segunda atribuição substitui o par inteiro, mantendo a mesma chave.

Esta explicação e o exemplo abrangem APIs disponíveis no .NET 10. A definição do projeto LangVersion=preview não significa que o próprio tipo seja uma funcionalidade experimental da linguagem.

Exemplos

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes