WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

Array.IndexOf — Index des ersten Vorkommens

System.Array.IndexOf findet das erste Vorkommen eines Werts in einem Array oder einem Bereich und gibt dessen Index zurück.

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

Syntax

Array.IndexOf<T>(T[] array, T value)
Array.IndexOf<T>(T[] array, T value, int startIndex)
Array.IndexOf<T>(T[] array, T value, int startIndex, int count)

System.Array.IndexOf durchsucht ein eindimensionales Array. Generische Überladungen geben einen nullbasierten Index zurück oder -1, wenn kein Treffer vorliegt.

startIndex legt den Beginn des Bereichs fest; count gibt dessen Länge an. Das Ergebnis bezieht sich auf das ursprüngliche Array. Verglichen wird mit EqualityComparer<T>.Default; die Suche hat für den durchsuchten Bereich eine Komplexität von O(n).

Bei einem null-Array wird ArgumentNullException ausgelöst, bei einem ungültigen Bereich ArgumentOutOfRangeException. Nicht generische Überladungen akzeptieren Array und object?; bei mehrdimensionalen Arrays lösen sie RankException aus. Ihr Rückgabewert bei fehlendem Treffer ist die untere Arraygrenze minus eins, üblicherweise -1.

Beispiele

using System;

int[] values = { 7, 4, 7, 9 };
Console.WriteLine(Array.IndexOf(values, 7));
Console.WriteLine(Array.IndexOf(values, 7, 1));
Console.WriteLine(Array.IndexOf(values, 7, 1, 1));

Ergebnis

0
2
-1

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.

Quellen