WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

IReadOnlyDictionary<TKey, TValue> — ein zum Lesen bereitgestelltes Wörterbuch

IReadOnlyDictionary<TKey, TValue> ermöglicht den lesenden Zugriff auf Schlüssel-Wert-Paare, ohne Änderungsoperationen bereitzustellen. Es garantiert keine unveränderlichen Daten. Lernen Sie Suchmöglichkeiten und CollectionExtensions.GetValueOrDefault kennen.

Version: .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> aus System.Collections.Generic beschreibt den Zugriff auf Paare mit eindeutigen Schlüsseln. Es stellt Count, Keys, Values, einen Indexer, ContainsKey und TryGetValue bereit. Die Iteration liefert KeyValuePair<TKey, TValue>; die Schnittstelle legt keine Reihenfolge fest.

Schreibgeschützt bedeutet nicht unveränderlich. Die Schnittstelle stellt keine Änderungsoperationen bereit, aber ein zugrunde liegendes Dictionary<TKey, TValue> kann über eine andere Referenz geändert werden. Die Zuweisung an die Schnittstelle erstellt weder eine Kopie noch eine Momentaufnahme und friert auch keine als Werte gespeicherten Objekte ein.

Wenn ein Schlüssel möglicherweise fehlt, verwenden Sie TryGetValue(key, out value): Das bool-Ergebnis unterscheidet einen fehlenden Eintrag von einem gespeicherten Standardwert. CollectionExtensions.GetValueOrDefault ist eine Erweiterungsmethode und kein Schnittstellenmember. Für den Aufruf mit Erweiterungssyntax muss die Methode an der Aufrufstelle im Gültigkeitsbereich liegen, etwa wenn sich der aufrufende Code im Namespace System.Collections.Generic befindet oder dieser Namespace mit using System.Collections.Generic; oder global using System.Collections.Generic; importiert wurde. Bei einem fehlenden Schlüssel gibt GetValueOrDefault(key) default(TValue) zurück, während GetValueOrDefault(key, defaultValue) den angegebenen Ersatzwert zurückgibt. Keine der Überladungen fügt einen Eintrag hinzu; bei einem null-Wörterbuch wird ArgumentNullException ausgelöst.

Das .NET-10-Beispiel zeigt beide Überladungen, das Erkennen eines vorhandenen Eintrags mit dem Wert 0 und die Sichtbarkeit einer späteren Änderung am zugrunde liegenden Wörterbuch. Es benötigt keine Sprachfunktionen der Preview-Version.

Beispiele

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

Ergebnis

3
0
-1
True
0
5

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen