CKTIS / C#
GetValueOrDefault op IReadOnlyDictionary
Zoek een waarde op met een terugvalwaarde en onderscheid zo nodig een ontbrekende sleutel van een opgeslagen `null`.
Versie: C# 12 and .NET 8; later runtimes may add compatible features
Syntax
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 en .NET 8 roept dictionary.GetValueOrDefault(key) een extensiemethode aan van CollectionExtensions in de naamruimte System.Collections.Generic, geen instantiemethode van IReadOnlyDictionary<TKey, TValue>. Maak de extensie beschikbaar met using System.Collections.Generic; of toon de herkomst met de gelijkwaardige statische aanroep CollectionExtensions.GetValueOrDefault(dictionary, key). Dictionary<TKey, TValue> implementeert de alleen-lezeninterface, maar een variabele die alleen als IDictionary<TKey, TValue> is gedeclareerd biedt deze extensie niet. Alleen-lezen toegang garandeert niet dat de onderliggende collectie onveranderlijk is.
Beide overbelastingen geven bij een bestaande sleutel de opgeslagen waarde terug, ook als die null is. Ontbreekt de sleutel, dan geeft de versie zonder terugvalwaarde default(TValue) terug (bijvoorbeeld null voor een referentietype of 0 voor int); de andere geeft de opgegeven defaultValue terug. De argumentexpressie wordt vóór de aanroep geëvalueerd, ook als de sleutel bestaat. Bij dictionary.GetValueOrDefault(key) ?? fallback moet het resultaat van de zoekactie als linkeroperand van ?? kunnen dienen, zoals Cmd? in het voorbeeld. Dan wordt fallback alleen geëvalueerd en gebruikt als de zoekactie null oplevert, ook als null de opgeslagen waarde is. Met TValue = int compileert deze expressie niet, omdat de zoekactie een int oplevert die niet null kan zijn.
Gebruik TryGetValue(key, out var value) en controleer de geretourneerde bool om een ontbrekende sleutel te onderscheiden van een opgeslagen waarde die gelijk is aan de standaard- of terugvalwaarde. Een ontbrekende sleutel veroorzaakt in GetValueOrDefault geen uitzondering, maar een woordenboek dat null is wel: ArgumentNullException. Dictionary<TKey, TValue> weigert ook een null-sleutel met die uitzondering.
Met #nullable enable geeft Cmd? aan dat een Cmd-referentie null mag zijn. Het is een annotatie voor compileranalyse, geen omhulling en geen controle tijdens de uitvoering. De woordenboekextensie verschilt van de instantiemethode Nullable<T>.GetValueOrDefault() voor waardetypen die null toelaten.
In een mini-DSL controleert de parser de tekst aan de hand van de grammatica en bouwt een abstracte syntaxisboom (AST). De evaluator interpreteert alleen ondersteunde knopen en zoekt opdrachtnamen op in een register. Geef de tekst niet door aan JavaScripts eval. Als een onbekende opdracht een fout is, meld die dan met behulp van TryGetValue in plaats van stilzwijgend een terugvalopdracht te kiezen.
Voorbeelden
#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);
Resultaat
hit: PRINT missing: <null> missing with fallback: FALLBACK stored null with fallback: <null> static: FALLBACK presence of missing: False presence of disabled: True
`missing` ontbreekt, terwijl bij `disabled` `null` is opgeslagen. Alleen de ontbrekende sleutel geeft `FALLBACK`; de twee `TryGetValue`-aanroepen laten zien welke sleutel bestaat.
Gerelateerde lessen
- C# · Les 57 · Gevorderd · Versie: 3
Bronnen
- 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>