База знанияИзпитен център
BGБългарски
Избери език13

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

Източници