CKTIS / C#
IndexOutOfRangeException — индекс извън границите
System.IndexOutOfRangeException сигнализира, наред с други случаи, опит за четене или запис на елемент от масив с невалиден индекс. Обикновено коригирайте изчисляването на индекса или границите на цикъла, вместо да използвате изключението за нормалния ход на програмата.
Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Синтаксис
array[index]
catch (System.IndexOutOfRangeException ex) { /* diagnostic handling */ }System.IndexOutOfRangeException е изключение, което се хвърля, наред с други случаи, при четене или запис на елемент от масив извън границите му. Обикновено то показва грешка в кода, чиято причина трябва да бъде открита и отстранена, вместо да бъде прикривана чрез прихващане на изключението.
За едномерен масив int[] индексът е валиден, ако изпълнява условието 0 <= index && index < values.Length. Length означава броя на елементите, а не последния индекс. Празният масив няма валиден индекс. В цикъл използвайте i < values.Length, а не i <= values.Length; ако са ви нужни само стойностите, изберете foreach.
Не всеки индексатор хвърля едно и също изключение. При индекс, по-малък от 0 или по-голям или равен на Count, List<T> хвърля ArgumentOutOfRangeException, а не IndexOutOfRangeException. Типът на изключението зависи от използвания API, въпреки сходния синтаксис [].
Примерът умишлено чете values[values.Length] и прихваща изключението единствено с демонстративна цел. След това правилен цикъл извежда всички елементи. В реален код коригирайте границите или проверете индекса преди достъп; не използвайте catch като нормално условие за прекратяване на цикъл.
Примери
using System;
internal static class Program
{
private static void Main()
{
int[] values = { 10, 20, 30 };
int index = values.Length;
try
{
Console.WriteLine(values[index]);
}
catch (IndexOutOfRangeException ex)
{
Console.WriteLine(ex.GetType().Name);
}
for (int i = 0; i < values.Length; i++)
{
Console.WriteLine(values[i]);
}
}
}Резултат
IndexOutOfRangeException 10 20 30
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.