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

CKTIS / C#

GetValueOrDefault en IReadOnlyDictionary

Consulta un diccionario con un valor alternativo y distingue, cuando sea necesario, una clave ausente de un `null` almacenado.

Versión: C# 12 and .NET 8; later runtimes may add compatible features

Sintaxis

using System.Collections.Generic;

// Extension signatures on System.Collections.Generic.CollectionExtensions:
public static TValue? GetValueOrDefault<TKey, TValue>(this IReadOnlyDictionary<TKey, TValue> dictionary, TKey key);
public static TValue GetValueOrDefault<TKey, TValue>(this IReadOnlyDictionary<TKey, TValue> dictionary, TKey key, TValue defaultValue);

// Extension call and equivalent static call:
dictionary.GetValueOrDefault(key);
CollectionExtensions.GetValueOrDefault(dictionary, key);
dictionary.GetValueOrDefault(key, defaultValue);
CollectionExtensions.GetValueOrDefault(dictionary, key, defaultValue);

En C# 12 y .NET 8, dictionary.GetValueOrDefault(key) llama a un método de extensión de CollectionExtensions en el espacio de nombres System.Collections.Generic, no a un miembro de instancia de IReadOnlyDictionary<TKey, TValue>. Importa la extensión con using System.Collections.Generic; o muestra su procedencia con la llamada estática equivalente CollectionExtensions.GetValueOrDefault(dictionary, key). Dictionary<TKey, TValue> implementa la interfaz de solo lectura, pero una variable declarada únicamente como IDictionary<TKey, TValue> no ofrece esta extensión. El acceso de solo lectura no garantiza que la colección subyacente sea inmutable.

Ambas sobrecargas devuelven el valor almacenado si la clave existe, incluso si es null. Si falta la clave, la sobrecarga sin valor alternativo devuelve default(TValue) (por ejemplo, null para un tipo de referencia o 0 para int); la otra devuelve el defaultValue indicado. La expresión del argumento se evalúa antes de la llamada, incluso si existe la clave. En cambio, dictionary.GetValueOrDefault(key) ?? fallback requiere que el resultado de la consulta pueda ser el operando izquierdo de ??, como ocurre con Cmd? en el ejemplo. En ese caso, solo evalúa y usa fallback si la consulta devuelve null, incluso cuando null es el valor almacenado. Con TValue = int, esta expresión no compila porque la consulta devuelve un int que no admite null.

Para distinguir una clave ausente de un valor almacenado igual al predeterminado o al alternativo, usa TryGetValue(key, out var value) y comprueba el bool devuelto. La ausencia de una clave no genera una excepción en GetValueOrDefault, pero un diccionario null provoca ArgumentNullException. Dictionary<TKey, TValue> también rechaza una clave null con esa excepción.

Con #nullable enable, Cmd? indica que una referencia a Cmd puede ser null. Es una anotación para el análisis del compilador, no una envoltura ni una comprobación en tiempo de ejecución. Esta extensión es distinta del método de instancia Nullable<T>.GetValueOrDefault() para tipos de valor que admiten null.

En un mini-DSL, el analizador sintáctico comprueba el texto según la gramática y construye un árbol de sintaxis abstracta (AST). El evaluador interpreta solo los nodos admitidos y resuelve los nombres de comandos mediante un registro. No pases el texto a eval de JavaScript. Si un comando desconocido es un error, notifícalo con ayuda de TryGetValue en lugar de elegir silenciosamente un comando alternativo.

Ejemplos

#nullable enable
using System;
using System.Collections.Generic;

IReadOnlyDictionary<string, Cmd?> commands = new Dictionary<string, Cmd?>(StringComparer.Ordinal)
{
    ["print"] = new Cmd("PRINT"),
    ["disabled"] = null
};
var fallback = new Cmd("FALLBACK");

Console.WriteLine($"hit: {Show(commands.GetValueOrDefault("print"))}");
Console.WriteLine($"missing: {Show(commands.GetValueOrDefault("missing"))}");
Console.WriteLine($"missing with fallback: {Show(commands.GetValueOrDefault("missing", fallback))}");
Console.WriteLine($"stored null with fallback: {Show(commands.GetValueOrDefault("disabled", fallback))}");
Console.WriteLine($"static: {Show(CollectionExtensions.GetValueOrDefault(commands, "missing", fallback))}");
Console.WriteLine($"presence of missing: {commands.TryGetValue("missing", out _)}");
Console.WriteLine($"presence of disabled: {commands.TryGetValue("disabled", out _)}");

static string Show(Cmd? cmd) => cmd?.Name ?? "<null>";

sealed record Cmd(string Name);

Resultado

hit: PRINT
missing: <null>
missing with fallback: FALLBACK
stored null with fallback: <null>
static: FALLBACK
presence of missing: False
presence of disabled: True

`missing` no existe y `disabled` contiene `null`. Solo la clave ausente recibe `FALLBACK`; las dos llamadas a `TryGetValue` muestran qué clave existe.

Lecciones relacionadas

  • C# · Lección 57 · Avanzado · Versión: 3

Fuentes