What is IndexOutOfRangeException in C# and How It Works

In C#, IndexOutOfRangeException is an error that happens when you try to access an array or collection element using an index that is outside its valid range. This means you are asking for a position that does not exist in the array or list.

How It Works

Imagine you have a row of mailboxes numbered from 0 to 4. If you try to open mailbox number 5, it doesn't exist, so you get an error. In C#, arrays and lists work the same way: they have positions starting at 0 up to one less than their size.

The IndexOutOfRangeException happens when your program tries to get or set a value at a position outside these limits. This is like reaching for a mailbox that is not there.

This exception helps catch mistakes early, so you can fix the code to only use valid positions.

Example

This example shows an array with 3 elements. Trying to access the element at index 3 causes an IndexOutOfRangeException because valid indexes are 0, 1, and 2.

csharp

using System;

class Program
{
    static void Main()
    {
        int[] numbers = {10, 20, 30};
        try
        {
            Console.WriteLine(numbers[3]); // Invalid index
        }
        catch (IndexOutOfRangeException e)
        {
            Console.WriteLine("Error: " + e.Message);
        }
    }
}

Output

Error: Index was outside the bounds of the array.

When to Use

You don't "use" IndexOutOfRangeException directly; it is thrown by the system to warn you about invalid index access. You should write code that avoids this error by always checking that indexes are within the valid range before accessing arrays or lists.

In real-world programs, this helps prevent crashes and bugs when working with collections of data, like lists of users, items, or scores.

Handling this exception gracefully can improve user experience by showing friendly error messages or fallback actions.

Key Points

• IndexOutOfRangeException occurs when accessing an invalid index in arrays or collections.
• Array indexes start at 0 and go up to length minus one.
• Always check index bounds before accessing elements.
• Use try-catch blocks to handle this exception if needed.
• This exception helps catch bugs early and prevents program crashes.

Key Takeaways

IndexOutOfRangeException happens when you access an array or list with an invalid index.

Array indexes start at 0 and go up to one less than the array length.

Always check that your index is within valid bounds before using it.

Use try-catch to handle this exception and keep your program running smoothly.

This exception helps you find and fix bugs related to invalid data access.