KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

IReadOnlyDictionary<TKey, TValue> — een woordenboek dat voor lezen beschikbaar is

IReadOnlyDictionary<TKey, TValue> biedt leestoegang tot sleutel-waardeparen zonder wijzigingsbewerkingen. Het garandeert niet dat de gegevens onveranderlijk zijn. Leer de zoekmogelijkheden en CollectionExtensions.GetValueOrDefault kennen.

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

Syntax

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> uit System.Collections.Generic beschrijft toegang tot paren met unieke sleutels. Het biedt Count, Keys, Values, een indexer, ContainsKey en TryGetValue. Iteratie levert KeyValuePair<TKey, TValue> op; de interface legt geen volgorde vast.

Alleen-lezen betekent niet onveranderlijk. De interface biedt geen wijzigingsbewerkingen, maar een onderliggende Dictionary<TKey, TValue> kan via een andere referentie worden gewijzigd. Toewijzing aan de interface maakt geen kopie of momentopname en bevriest ook geen objecten die als waarden zijn opgeslagen.

Als een sleutel mogelijk ontbreekt, gebruik je TryGetValue(key, out value): het resultaat bool maakt onderscheid tussen een ontbrekende entry en een opgeslagen standaardwaarde. CollectionExtensions.GetValueOrDefault is een extensiemethode en geen interfacelid. Om de extensiesyntaxis te gebruiken, moet de methode binnen het bereik van de aanroep vallen, bijvoorbeeld doordat de aanroepende code in de naamruimte System.Collections.Generic staat of doordat die naamruimte is geïmporteerd met using System.Collections.Generic; of global using System.Collections.Generic;. Bij een ontbrekende sleutel retourneert GetValueOrDefault(key) default(TValue), terwijl GetValueOrDefault(key, defaultValue) de opgegeven terugvalwaarde retourneert. Geen van beide overloads voegt een entry toe; bij een null-woordenboek wordt ArgumentNullException veroorzaakt.

Het .NET 10-voorbeeld laat beide overloads zien, het herkennen van een bestaande entry met waarde 0 en de zichtbaarheid van een latere wijziging aan het onderliggende woordenboek. Er zijn geen preview-taalfuncties voor nodig.

Voorbeelden

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"]);

Resultaat

3
0
-1
True
0
5

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen