Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła