Исключения IndexOutOfRange и ArgumentOutOfRange в C#

Обновлено: 31.10.2026 · 3 мин чтения

Что такое IndexOutOfRangeException?

Это исключение возникает при выходе за границы массива. Ниже разобраны его причины.

Определение и причины возникновения

IndexOutOfRangeException возникает тогда, когда попытка доступа к элементу массива, списка или другой коллекции происходит по индексу, который выходит за границы допустимых значений. Аналогично, если вы попытаетесь взять книгу с полки, где книг всего 10, а вы протянете руку к 11-й позиции, в реальной жизни вы просто не найдёте книгу, но в C# программа “выдаст ошибку”, так как индекс вне допустимого диапазона.

Пример кода с ошибкой

int[] numbers = { 1, 2, 3, 4, 5 };
int number = numbers[5]; // IndexOutOfRangeException

Ошибку проще предотвратить, чем исправлять потом.

Как предотвратить

Чтобы избежать IndexOutOfRangeException, всегда проверяйте границы массива перед доступом к его элементам:

int[] numbers = { 1, 2, 3, 4, 5 };
if (index >= 0 && index < numbers.Length)
{
    int number = numbers[index];
}

Что такое ArgumentOutOfRangeException?

Похожая ошибка встречается при работе с коллекциями вроде List. Сначала определим, когда именно она появляется.

Определение и контекст возникновения

ArgumentOutOfRangeException выбрасывается, когда значение аргумента, переданного в метод, находится вне диапазона допустимых значений, определяемых этим методом. Представьте, что вы заказываете пиццу и указываете размер, который не предусмотрен меню - в реальном мире вам скажут, что такого размера нет, а в программе это приведёт к ArgumentOutOfRangeException.

Пример ошибки с ArgumentOutOfRangeException

void SetTemperature(int temperature)
{
    if (temperature < -273 || temperature > 1000)
    {
        throw new ArgumentOutOfRangeException(nameof(temperature));
    }

    // Код для установки температуры
}

SetTemperature(1500); // ArgumentOutOfRangeException

Для ArgumentOutOfRangeException подход похожий: значения нужно проверять заранее.

Как избежать

Для предотвращения ArgumentOutOfRangeException, всегда проверяйте аргументы на допустимость перед использованием:

void SetTemperature(int temperature)
{
    if (temperature < -273 || temperature > 1000)
    {
        // Обработка недопустимого значения
    }
    else
    {
        // Код для установки температуры
    }
}

Обработка исключений с try-catch

Даже при проверках исключения полностью не исключены, поэтому код стоит обернуть в обработчик. Ниже показано, как устроена такая конструкция.

Применение конструкции try-catch

Для обработки возникающих исключений используйте блок try-catch. Это позволит вашей программе продолжить работу, даже если возникнут ошибки.

Пример кода с обработкой исключения

try
{
    int[] numbers = { 1, 2, 3, 4, 5 };
    int number = numbers[5];
}
catch (IndexOutOfRangeException ex)
{
    // Логирование или коррекция ошибки
}

Несколько общих правил помогут реже встречаться с такими исключениями.

Лучшие практики программирования для избегания исключений

Большинство ошибок выхода за границы можно предотвратить ещё на этапе написания кода, если следовать нескольким простым правилам.

Проверка предусловий

Перед выполнением операций всегда проверяйте предусловия. Используйте проверки в начале методов для исключения недопустимых сценариев.

Использование встроенных методов .NET

Используйте встроенные методы и свойства, такие как Length массива или Count коллекции, для проверки границ перед доступом к элементам.

Тестирование и отладка кода

Чтобы исключения возникали реже, помогают тесты и отладчик. Рассмотрим подходы, которые легко применить на практике.

Методы и подходы

Регулярно тестируйте ваши методы с различными входными данными, включая граничные случаи. Используйте отладку для поиска и исправления проблем в коде.

Инструменты отладки

Интегрированные среды разработки (IDE), такие как Visual Studio, предоставляют мощные инструменты отладки, которые помогают быстро находить и исправлять ошибки.

Примеры решения распространённых ошибок

В заключение разберём типичные случаи и их исправление. Начнём с работы с массивами и коллекциями.

Работа с массивами и коллекциями

При работе с массивами и коллекциями всегда учитывайте их текущий размер. Не предполагайте, что размер неизменен.

Предварительная валидация данных

До передачи данных в методы проводите их предварительную валидацию. Это поможет предотвратить возникновение исключений из-за некорректных значений.

int[] numbers = { 1, 2, 3, 4, 5 };
int indexToAccess = 5;

if (indexToAccess >= 0 && indexToAccess < numbers.Length)
{
    int number = numbers[indexToAccess];
}
else
{
    // Обработка ситуации с недопустимым индексом
}

Исключения IndexOutOfRangeException и ArgumentOutOfRangeException могут быть вызовом для начинающих разработчиков, но осознанное использование проверок и обработка ошибок позволяют обеспечить надёжность и стабильность C# приложений. Следуйте лучшим практикам и используйте отладку для создания качественного и устойчивого к ошибкам кода.