CKTIS / C#
GetValueOrDefault su IReadOnlyDictionary
Leggi un valore dal dizionario con un valore di ripiego e distingui, quando serve, una chiave assente da un `null` memorizzato.
Versione: C# 12 and .NET 8; later runtimes may add compatible features
Sintassi
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);In C# 12 e .NET 8, dictionary.GetValueOrDefault(key) invoca un metodo di estensione di CollectionExtensions nello spazio dei nomi System.Collections.Generic, non un membro di istanza di IReadOnlyDictionary<TKey, TValue>. Importa l’estensione con using System.Collections.Generic; o rendine esplicita la provenienza con la chiamata statica equivalente CollectionExtensions.GetValueOrDefault(dictionary, key). Dictionary<TKey, TValue> implementa l’interfaccia di sola lettura, ma una variabile dichiarata solo come IDictionary<TKey, TValue> non espone l’estensione. L’accesso in sola lettura non garantisce l’immutabilità della raccolta sottostante.
Entrambi gli overload restituiscono il valore memorizzato se la chiave esiste, anche se è null. Se la chiave manca, l’overload senza valore di ripiego restituisce default(TValue) (ad esempio null per un tipo riferimento o 0 per int); l’altro restituisce il defaultValue fornito. L’espressione dell’argomento viene valutata prima della chiamata, anche se la chiave esiste. Invece dictionary.GetValueOrDefault(key) ?? fallback richiede che il risultato della ricerca possa essere l’operando sinistro di ??, come nel caso di Cmd? nell’esempio. In quel caso, fallback viene valutato e usato solo se la ricerca restituisce null, anche quando null è il valore memorizzato. Con TValue = int, questa espressione non compila perché la ricerca restituisce un int che non ammette null.
Per distinguere una chiave assente da un valore memorizzato uguale a quello predefinito o di ripiego, usa TryGetValue(key, out var value) e controlla il bool restituito. Una chiave assente non causa un’eccezione in GetValueOrDefault, ma un dizionario null causa ArgumentNullException. Dictionary<TKey, TValue> rifiuta anche una chiave null con la stessa eccezione.
Con #nullable enable, Cmd? indica che un riferimento a Cmd può essere null. È un’annotazione per l’analisi del compilatore, non un involucro né un controllo a runtime. L’estensione del dizionario è distinta dal metodo di istanza Nullable<T>.GetValueOrDefault() per i tipi valore nullable.
In un mini-DSL, il parser verifica il testo rispetto alla grammatica e costruisce un albero sintattico astratto (AST). Il valutatore interpreta soltanto i nodi supportati e risolve i nomi dei comandi mediante un registro. Non passare il testo a eval di JavaScript. Se un comando sconosciuto è un errore, segnalalo con l’aiuto di TryGetValue anziché scegliere in silenzio un comando di ripiego.
Esempi
#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);
Risultato
hit: PRINT missing: <null> missing with fallback: FALLBACK stored null with fallback: <null> static: FALLBACK presence of missing: False presence of disabled: True
`missing` è assente, mentre `disabled` contiene `null`. Solo la chiave assente restituisce `FALLBACK`; le due chiamate a `TryGetValue` mostrano quale chiave esiste.
Lezioni correlate
- C# · Lezione 57 · Avanzato · Versione: 3
Fonti
- CollectionExtensions.GetValueOrDefault Method
- IReadOnlyDictionary<TKey,TValue> Interface
- IReadOnlyDictionary<TKey,TValue>.TryGetValue(TKey, TValue) Method
- Dictionary<TKey,TValue>.TryGetValue(TKey, TValue) Method
- How to implement and call a custom extension method
- Nullable reference types
- ?? and ??= operators - the null-coalescing operators
- Get started with syntax analysis (Roslyn APIs)
- C# language versioning
- dotnet new <TEMPLATE>