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

CKTIS / C#

IReadOnlyDictionary<TKey, TValue> — un diccionario expuesto para lectura

IReadOnlyDictionary<TKey, TValue> permite leer pares clave-valor sin ofrecer operaciones de modificación. No garantiza que los datos sean inmutables. Aprende las opciones de búsqueda y CollectionExtensions.GetValueOrDefault.

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

Sintaxis

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 describe el acceso a pares con claves únicas. Expone Count, Keys, Values, un indexador, ContainsKey y TryGetValue. La iteración produce KeyValuePair<TKey, TValue>; la interfaz no establece ningún orden.

Solo lectura no significa inmutable. La interfaz no ofrece operaciones de modificación, pero un Dictionary<TKey, TValue> subyacente puede cambiar a través de otra referencia. Asignarlo a la interfaz no crea una copia ni una instantánea, y tampoco congela los objetos almacenados como valores.

Si una clave podría no existir, usa TryGetValue(key, out value): su resultado bool distingue una entrada ausente de un valor predeterminado almacenado. CollectionExtensions.GetValueOrDefault es un método de extensión, no un miembro de la interfaz. Para usar la sintaxis de método de extensión, el método debe estar al alcance en el punto de llamada, por ejemplo, si el código que lo llama está en el espacio de nombres System.Collections.Generic o si ese espacio de nombres se ha importado con using System.Collections.Generic; o global using System.Collections.Generic;. Si falta la clave, GetValueOrDefault(key) devuelve default(TValue), mientras que GetValueOrDefault(key, defaultValue) devuelve el valor alternativo indicado. Ninguna de las dos sobrecargas añade una entrada; un diccionario null provoca ArgumentNullException.

El ejemplo de .NET 10 muestra ambas sobrecargas, cómo detectar una entrada existente cuyo valor es 0 y cómo se refleja un cambio posterior en el diccionario subyacente. No requiere características del lenguaje en versión preliminar.

Ejemplos

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

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