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.