WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

ArgumentOutOfRangeException und KeyNotFoundException: Listenindex oder Wörterbuchschlüssel

Eckige Klammern greifen bei einer Liste über die Position und bei einem Wörterbuch über den Schlüssel zu. Ein ungültiger Index und ein fehlender Schlüssel lösen verschiedene Ausnahmen aus.

Version: C# 12 and .NET 8; later runtimes may add compatible features

Syntax

List<T>: T this[int index] { get; set; } — list[index]
Dictionary<TKey, TValue>: TValue this[TKey key] { get; set; } — dictionary[key]
Dictionary<TKey, TValue>: bool TryGetValue(TKey key, out TValue value)

System.ArgumentOutOfRangeException bedeutet, dass ein Argument außerhalb des zulässigen Bereichs liegt. Der Indexer von List<T> löst diese Ausnahme beim Lesen oder Schreiben von list[index] aus, wenn index < 0 oder index >= list.Count gilt. Die Positionen beginnen bei null. Bei einem Array führt ein Zugriff außerhalb der Arraygrenzen dagegen zu System.IndexOutOfRangeException.

Beim Lesen von dictionary[key] aus einem Dictionary<TKey, TValue> wird System.Collections.Generic.KeyNotFoundException ausgelöst, wenn kein passender Schlüssel existiert. Auch ein Schlüssel vom Typ int ist keine Position. dictionary[key] = value fügt bei einem fehlenden Schlüssel einen Eintrag hinzu oder ersetzt bei einem vorhandenen Schlüssel den Wert. Ein null-Schlüssel führt zu ArgumentNullException, nicht zu KeyNotFoundException.

Wenn ein Index ungültig sein könnte, prüfe vor dem Listenzugriff 0 <= index && index < list.Count. Wenn ein Schlüssel fehlen darf, nutze TryGetValue(key, out var value). Die Methode liefert true und den gespeicherten Wert, wenn der Schlüssel vorhanden ist, sonst false und default(TValue). Prüfe das boolesche Ergebnis statt nur den Wert: Auch der Standardwert kann im Wörterbuch gespeichert sein. Bei einem null-Schlüssel löst auch TryGetValue eine ArgumentNullException aus.

Beispiele

using System;
using System.Collections.Generic;

var list = new List<int> { 0 };
var dictionary = new Dictionary<int, int> { [0] = 0 };
int indexOrKey = 1;

try
{
    _ = list[indexOrKey];
}
catch (ArgumentOutOfRangeException ex)
{
    Console.WriteLine($"List: {ex.GetType().Name}");
}

try
{
    _ = dictionary[indexOrKey];
}
catch (KeyNotFoundException ex)
{
    Console.WriteLine($"Dictionary: {ex.GetType().Name}");
}

if (!dictionary.TryGetValue(indexOrKey, out _))
{
    Console.WriteLine("TryGetValue: key not found");
}

Ergebnis

List: ArgumentOutOfRangeException
Dictionary: KeyNotFoundException
TryGetValue: key not found

`1` liegt außerhalb der Grenzen der Liste mit einem Element und fehlt als Wörterbuchschlüssel. Die Indexer selbst lösen die Ausnahmen aus; die `catch`-Blöcke geben nur die Typnamen aus. `TryGetValue` behandelt denselben fehlenden Schlüssel ohne Ausnahme.

Zugehörige Lektionen

  • C# · Lektion 7 · Mittlere Stufe · Version: 2

Quellen