Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

IndexOutOfRangeException — index hors limites

System.IndexOutOfRangeException signale notamment une tentative de lecture ou d’écriture d’un élément de tableau avec un index invalide. En général, corrigez le calcul de l’index ou les limites de la boucle plutôt que d’utiliser l’exception pour le déroulement normal du programme.

Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntaxe

array[index]
catch (System.IndexOutOfRangeException ex) { /* diagnostic handling */ }

System.IndexOutOfRangeException est une exception déclenchée notamment lors de la lecture ou de l’écriture d’un élément de tableau en dehors de ses limites. Elle indique généralement une erreur de programmation dont il faut trouver et corriger la cause, plutôt que de la masquer en interceptant l’exception.

Pour un tableau unidimensionnel int[], un index valide satisfait la condition 0 <= index && index < values.Length. Length désigne le nombre d’éléments, et non le dernier index. Un tableau vide ne possède aucun index valide. Dans une boucle, utilisez i < values.Length, et non i <= values.Length ; si vous avez seulement besoin des valeurs, choisissez foreach.

Tous les indexeurs ne déclenchent pas la même exception. Pour un index inférieur à 0 ou supérieur ou égal à Count, List<T> déclenche ArgumentOutOfRangeException, et non IndexOutOfRangeException. Le type d’exception dépend de l’API utilisée, même si la syntaxe [] est similaire.

L’exemple lit volontairement values[values.Length] et intercepte l’exception uniquement à des fins de démonstration. Une boucle correcte affiche ensuite tous les éléments. Dans du code réel, corrigez les limites ou vérifiez l’index avant l’accès ; ne traitez pas catch comme la condition normale de fin d’une boucle.

Exemples

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]);
        }
    }
}

Résultat

IndexOutOfRangeException
10
20
30

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources