Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje