CKTIS / C#
ArgumentOutOfRangeException in KeyNotFoundException: indeks seznama ali ključ slovarja
Oglati oklepaji pri seznamu pomenijo dostop po položaju, pri slovarju pa dostop po ključu. Neveljaven indeks in manjkajoči ključ sprožita različni izjemi.
Različica: C# 12 and .NET 8; later runtimes may add compatible features
Sintaksa
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 pomeni, da je argument zunaj dovoljenega obsega. Indeksator tipa List<T> sproži to izjemo pri branju ali pisanju list[index], če velja index < 0 ali index >= list.Count. Položaji se štejejo od nič. Dostop zunaj meja polja pa sproži System.IndexOutOfRangeException.
Branje dictionary[key] iz slovarja Dictionary<TKey, TValue> sproži System.Collections.Generic.KeyNotFoundException, če ustreznega ključa ni. Tudi ključ tipa int ne pomeni položaja. Prirejanje dictionary[key] = value doda vnos za manjkajoči ključ ali zamenja vrednost za obstoječi ključ. Ključ null povzroči ArgumentNullException, ne KeyNotFoundException.
Če je indeks lahko neveljaven, pred dostopom do seznama preveri 0 <= index && index < list.Count. Če je manjkajoči ključ pričakovan, uporabi TryGetValue(key, out var value). Metoda vrne true in posreduje shranjeno vrednost, če najde ključ; sicer vrne false in posreduje default(TValue). Preveri logični rezultat in ne le vrednosti: tudi privzeta vrednost je lahko shranjena v slovarju. Tudi TryGetValue zavrne ključ null z izjemo ArgumentNullException.
Primeri
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");
}Rezultat
List: ArgumentOutOfRangeException Dictionary: KeyNotFoundException TryGetValue: key not found
`1` je zunaj meja seznama z enim elementom in ga v slovarju ni kot ključa. Izjemi sprožita indeksatorja sama; bloka `catch` samo izpišeta imeni tipov. `TryGetValue` obravnava isti manjkajoči ključ brez izjeme.
Povezane lekcije
- C# · Lekcija 7 · Srednja · Različica: 2