CKTIS / C#
ArgumentOutOfRangeException i KeyNotFoundException: indeks listy a klucz słownika
Nawiasy `[]` oznaczają na liście dostęp według pozycji, a w słowniku dostęp według klucza. Nieprawidłowy indeks i brak klucza powodują różne wyjątki.
Wersja: C# 12 and .NET 8; later runtimes may add compatible features
Składnia
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 oznacza, że argument ma niedozwoloną wartość. Indekser List<T> zgłasza ten wyjątek przy odczycie lub zapisie list[index], gdy index < 0 lub index >= list.Count. Pozycje są numerowane od zera. Nie należy mylić tego z dostępem do tablicy: indeks poza jej granicami powoduje System.IndexOutOfRangeException.
Odczyt dictionary[key] z Dictionary<TKey, TValue> zgłasza System.Collections.Generic.KeyNotFoundException, jeśli nie ma pasującego klucza. Nawet klucz typu int nie oznacza pozycji. Zapis dictionary[key] = value dodaje wpis dla brakującego klucza lub zastępuje wartość istniejącego wpisu. Klucz null powoduje ArgumentNullException, nie KeyNotFoundException.
Jeśli indeks może być nieprawidłowy, przed dostępem do listy sprawdź 0 <= index && index < list.Count. Jeśli brak klucza jest spodziewany, użyj TryGetValue(key, out var value). Metoda zwraca true i zapisaną wartość, gdy klucz istnieje, albo false i default(TValue), gdy go brakuje. Sprawdzaj wynik logiczny, nie samą wartość: wartość domyślna też może być zapisana w słowniku. TryGetValue również odrzuca klucz null, zgłaszając ArgumentNullException.
Przykłady
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");
}Wynik
List: ArgumentOutOfRangeException Dictionary: KeyNotFoundException TryGetValue: key not found
`1` jest poza zakresem jednoelementowej listy i nie występuje jako klucz w słowniku. Wyjątki zgłaszają same indeksery; bloki `catch` wypisują tylko nazwy typów. `TryGetValue` obsługuje brak tego samego klucza bez wyjątku.
Powiązane lekcje
- C# · Lekcja 7 · Średniozaawansowany · Wersja: 2