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