CKTIS / C#
IReadOnlyDictionary<TKey, TValue> — um dicionário disponibilizado para leitura
IReadOnlyDictionary<TKey, TValue> permite ler pares chave-valor sem disponibilizar operações de alteração. Não garante que os dados sejam imutáveis. Conheça as opções de pesquisa e CollectionExtensions.GetValueOrDefault.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
IReadOnlyDictionary<TKey, TValue> view = dictionary;
TValue value = view[key];
bool found = view.TryGetValue(key, out TValue result);
TValue fallback = view.GetValueOrDefault(key, defaultValue);IReadOnlyDictionary<TKey, TValue> de System.Collections.Generic descreve o acesso a pares com chaves únicas. Disponibiliza Count, Keys, Values, um indexador, ContainsKey e TryGetValue. A iteração devolve KeyValuePair<TKey, TValue>; a interface não define uma ordem.
Só de leitura não significa imutável. A interface não disponibiliza operações de alteração, mas um Dictionary<TKey, TValue> subjacente pode ser alterado através de outra referência. Atribuí-lo à interface não cria uma cópia nem um instantâneo, e não torna imutáveis os objetos armazenados como valores.
Quando uma chave pode não existir, utilize TryGetValue(key, out value): o resultado bool distingue uma entrada em falta de um valor predefinido armazenado. CollectionExtensions.GetValueOrDefault é um método de extensão, não um membro da interface. Para utilizar a sintaxe dos métodos de extensão, o método tem de estar no âmbito da chamada, por exemplo, se o código que o chama estiver no espaço de nomes System.Collections.Generic ou se esse espaço de nomes tiver sido importado com using System.Collections.Generic; ou global using System.Collections.Generic;. Se a chave estiver em falta, GetValueOrDefault(key) devolve default(TValue), enquanto GetValueOrDefault(key, defaultValue) devolve o valor alternativo indicado. Nenhuma das sobrecargas adiciona uma entrada; um dicionário null provoca ArgumentNullException.
O exemplo .NET 10 demonstra ambas as sobrecargas, a deteção de uma entrada existente com o valor 0 e a visibilidade de uma alteração posterior ao dicionário subjacente. Não requer funcionalidades de linguagem em versão preview.
Exemplos
using System;
using System.Collections.Generic;
var stock = new Dictionary<string, int>
{
["pen"] = 3,
["paper"] = 0
};
IReadOnlyDictionary<string, int> view = stock;
Console.WriteLine(view["pen"]);
Console.WriteLine(view.GetValueOrDefault("eraser"));
Console.WriteLine(view.GetValueOrDefault("eraser", -1));
Console.WriteLine(view.TryGetValue("paper", out int count));
Console.WriteLine(count);
stock["pen"] = 5;
Console.WriteLine(view["pen"]);Resultado
3 0 -1 True 0 5
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.