CKTIS / C#
ArgumentOutOfRangeException a KeyNotFoundException: index seznamu nebo klíč slovníku
Hranaté závorky vybírají prvek seznamu podle pozice a hodnotu ve slovníku podle klíče. Neplatný index a chybějící klíč vyvolávají různé výjimky.
Verze: C# 12 and .NET 8; later runtimes may add compatible features
Syntaxe
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 znamená, že argument je mimo povolený rozsah. Indexer typu List<T> vyvolá tuto výjimku při čtení nebo zápisu list[index], pokud platí index < 0 nebo index >= list.Count. Pozice se počítají od nuly. Přístup mimo meze pole naopak vyvolá System.IndexOutOfRangeException.
Při čtení dictionary[key] ze slovníku Dictionary<TKey, TValue> se vyvolá System.Collections.Generic.KeyNotFoundException, pokud odpovídající klíč neexistuje. Ani klíč typu int není pozice. Přiřazení dictionary[key] = value přidá položku pro chybějící klíč nebo nahradí hodnotu existujícího klíče. Klíč null vyvolá ArgumentNullException, nikoli KeyNotFoundException.
Pokud by index mohl být neplatný, před přístupem k seznamu ověř 0 <= index && index < list.Count. Pokud klíč může běžně chybět, použij TryGetValue(key, out var value). Metoda vrátí true a předá uloženou hodnotu, když klíč najde; jinak vrátí false a předá default(TValue). Kontroluj logický výsledek, ne jen hodnotu: i výchozí hodnota může být uložená ve slovníku. Také TryGetValue odmítá klíč null výjimkou ArgumentNullException.
Příklady
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");
}Výsledek
List: ArgumentOutOfRangeException Dictionary: KeyNotFoundException TryGetValue: key not found
`1` je mimo rozsah jednoprvkového seznamu a ve slovníku jako klíč chybí. Výjimky vyvolávají samotné indexery; bloky `catch` jen vypisují názvy typů. `TryGetValue` zpracuje stejný chybějící klíč bez výjimky.
Související lekce
- C# · Lekce 7 · Středně pokročilá · Verze: 2