CKTIS / C#
ArgumentOutOfRangeException i KeyNotFoundException: indeks popisa ili ključ rječnika
Uglate zagrade služe za pristup popisu po položaju, a rječniku po ključu. Nevaljan indeks i ključ koji nedostaje uzrokuju različite iznimke.
Verzija: 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 znači da je argument izvan dopuštenog raspona. Indeksator tipa List<T> baca tu iznimku pri čitanju ili upisu list[index] ako vrijedi index < 0 ili index >= list.Count. Položaji se broje od nule. Pristup izvan granica polja, s druge strane, baca System.IndexOutOfRangeException.
Čitanje dictionary[key] iz rječnika Dictionary<TKey, TValue> baca System.Collections.Generic.KeyNotFoundException ako nema odgovarajućeg ključa. Čak ni ključ tipa int ne označava položaj. Dodjela dictionary[key] = value dodaje unos ako ključ ne postoji ili zamjenjuje vrijednost ako ključ postoji. Ključ null uzrokuje ArgumentNullException, a ne KeyNotFoundException.
Ako indeks može biti nevaljan, provjeri 0 <= index && index < list.Count prije pristupa popisu. Ako je očekivano da ključ može nedostajati, upotrijebi TryGetValue(key, out var value). Metoda vraća true i daje pohranjenu vrijednost ako pronađe ključ, a inače vraća false i daje default(TValue). Provjeri logički rezultat, a ne samo vrijednost: i zadana vrijednost može biti pohranjena u rječniku. TryGetValue također odbija ključ null bacanjem iznimke ArgumentNullException.
Primjeri
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 izvan granica popisa s jednim elementom i ne postoji kao ključ u rječniku. Iznimke bacaju sami indeksatori; blokovi `catch` samo ispisuju nazive tipova. `TryGetValue` obrađuje isti nedostajući ključ bez bacanja iznimke.
Povezane lekcije
- C# · Lekcija 7 · Srednje · Verzija: 2