CKTIS / C#
IndexOutOfRangeException — index buiten de grenzen
System.IndexOutOfRangeException geeft onder andere aan dat een arrayelement wordt gelezen of geschreven met een ongeldige index. Corrigeer doorgaans de indexberekening of de grenzen van de lus, in plaats van de uitzondering te gebruiken voor de normale programmastroom.
Versie: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
array[index]
catch (System.IndexOutOfRangeException ex) { /* diagnostic handling */ }System.IndexOutOfRangeException is een uitzondering die onder andere wordt gegenereerd wanneer een arrayelement buiten de grenzen wordt gelezen of geschreven. Dit wijst meestal op een programmeerfout waarvan je de oorzaak moet opsporen en verhelpen, in plaats van die te verbergen door de uitzondering af te vangen.
Voor een eendimensionale int[]-array geldt een index als geldig als 0 <= index && index < values.Length. Length is het aantal elementen, niet de laatste index. Een lege array heeft geen geldige index. Gebruik in een lus i < values.Length, niet i <= values.Length; als je alleen de waarden nodig hebt, kies dan foreach.
Niet elke indexer genereert dezelfde uitzondering. Bij een index kleiner dan 0 of groter dan of gelijk aan Count genereert List<T> ArgumentOutOfRangeException, niet IndexOutOfRangeException. Het uitzonderingstype hangt af van de gebruikte API, ook al is de syntaxis [] vergelijkbaar.
Het voorbeeld leest bewust values[values.Length] en vangt de uitzondering uitsluitend ter demonstratie op. Daarna drukt een correcte lus alle elementen af. Corrigeer in echte code de grenzen of controleer de index vóór toegang; gebruik catch niet als de normale voorwaarde om een lus te beëindigen.
Voorbeelden
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]);
}
}
}Resultaat
IndexOutOfRangeException 10 20 30
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.