CKTIS / C#
ArgumentOutOfRangeException и KeyNotFoundException: индекс в списък или ключ в речник
Квадратните скоби осигуряват достъп до списък по позиция, а до речник — по ключ. Невалиден индекс и липсващ ключ водят до различни изключения.
Версия: C# 12 and .NET 8; later runtimes may add compatible features
Синтаксис
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 означава, че аргументът е извън допустимия диапазон. Индексаторът на List<T> хвърля това изключение при четене или запис чрез list[index], ако index < 0 или index >= list.Count. Позициите започват от нула. Достъпът извън границите на масив, за разлика от това, хвърля System.IndexOutOfRangeException.
Четенето чрез dictionary[key] от Dictionary<TKey, TValue> хвърля System.Collections.Generic.KeyNotFoundException, ако няма съответстващ ключ. Дори ключ от тип int не означава позиция. Присвояването dictionary[key] = value добавя запис за липсващ ключ или заменя стойността за съществуващ ключ. Ключ null води до ArgumentNullException, а не до KeyNotFoundException.
Ако индексът може да е невалиден, провери 0 <= index && index < list.Count преди достъпа до списъка. Ако е нормално даден ключ да липсва, използвай TryGetValue(key, out var value). Методът връща true и предоставя записаната стойност, ако намери ключа, или връща false и предоставя default(TValue), ако ключът липсва. Проверявай булевия резултат, а не само стойността: стойността по подразбиране също може да е записана в речника. TryGetValue също отхвърля ключ null, като хвърля ArgumentNullException.
Примери
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");
}Резултат
List: ArgumentOutOfRangeException Dictionary: KeyNotFoundException TryGetValue: key not found
`1` е извън границите на списъка с един елемент и не присъства като ключ в речника. Самите индексатори хвърлят изключенията; блоковете `catch` само извеждат имената на типовете. `TryGetValue` обработва същия липсващ ключ без изключение.
Свързани уроци
- C# · Урок 7 · Средно · Версия: 2