Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje