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

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници