CKTIS / C#
IndexOutOfRangeException — Index außerhalb der Grenzen
System.IndexOutOfRangeException signalisiert unter anderem den Versuch, ein Arrayelement mit einem ungültigen Index zu lesen oder zu schreiben. Korrigiere normalerweise die Indexberechnung oder die Schleifengrenzen, statt die Ausnahme für den normalen Programmablauf zu verwenden.
Version: .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 ist eine Ausnahme, die unter anderem beim Lesen oder Schreiben eines Arrayelements außerhalb seiner Grenzen ausgelöst wird. Sie weist normalerweise auf einen Programmierfehler hin, dessen Ursache ermittelt und behoben werden sollte, statt ihn durch das Abfangen der Ausnahme zu verbergen.
Für ein eindimensionales Array int[] gilt ein Index als gültig, wenn 0 <= index && index < values.Length. Length bezeichnet die Anzahl der Elemente, nicht den letzten Index. Ein leeres Array hat keinen gültigen Index. Verwende in einer Schleife i < values.Length, nicht i <= values.Length; wenn du nur die Werte benötigst, verwende foreach.
Nicht jeder Indexer löst dieselbe Ausnahme aus. Bei einem Index kleiner als 0 oder größer oder gleich Count löst List<T> ArgumentOutOfRangeException aus, nicht IndexOutOfRangeException. Der Ausnahmetyp hängt von der verwendeten API ab, auch wenn die Syntax [] ähnlich ist.
Das Beispiel liest absichtlich values[values.Length] und fängt die Ausnahme nur zu Demonstrationszwecken ab. Anschließend gibt eine korrekte Schleife alle Elemente aus. Korrigiere im echten Code die Grenzen oder prüfe den Index vor dem Zugriff; verwende catch nicht als normale Bedingung zum Beenden einer Schleife.
Beispiele
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]);
}
}
}Ergebnis
IndexOutOfRangeException 10 20 30
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.