CKTIS / C#
ArgumentOutOfRangeException a KeyNotFoundException: index zoznamu alebo kľúč slovníka
Hranaté zátvorky vyberajú prvok zoznamu podľa pozície a hodnotu v slovníku podľa kľúča. Neplatný index a chýbajúci kľúč vyvolávajú odlišné výnimky.
Verzia: 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 znamená, že argument je mimo povoleného rozsahu. Indexer typu List<T> vyvolá túto výnimku pri čítaní alebo zápise list[index], ak platí index < 0 alebo index >= list.Count. Pozície sa počítajú od nuly. Prístup mimo hraníc poľa naopak vyvolá System.IndexOutOfRangeException.
Čítanie dictionary[key] zo slovníka Dictionary<TKey, TValue> vyvolá System.Collections.Generic.KeyNotFoundException, ak zodpovedajúci kľúč neexistuje. Ani kľúč typu int nepredstavuje pozíciu. Priradenie dictionary[key] = value pridá položku pre chýbajúci kľúč alebo nahradí hodnotu existujúceho kľúča. Kľúč null vyvolá ArgumentNullException, nie KeyNotFoundException.
Ak môže byť index neplatný, pred prístupom k zoznamu over 0 <= index && index < list.Count. Ak je neprítomnosť kľúča očakávaná, použi TryGetValue(key, out var value). Metóda vráti true a poskytne uloženú hodnotu, ak kľúč nájde; inak vráti false a poskytne default(TValue). Kontroluj logický výsledok, nie iba hodnotu: aj predvolená hodnota môže byť uložená v slovníku. Aj TryGetValue odmieta kľúč null výnimkou ArgumentNullException.
Prí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ýsledok
List: ArgumentOutOfRangeException Dictionary: KeyNotFoundException TryGetValue: key not found
`1` je mimo rozsahu jednoprvkového zoznamu a v slovníku ako kľúč chýba. Výnimky vyvolávajú samotné indexery; bloky `catch` iba vypisujú názvy typov. `TryGetValue` spracuje ten istý chýbajúci kľúč bez výnimky.
Súvisiace lekcie
- C# · Lekcia 7 · Stredne pokročilá · Verzia: 2