WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

Array.IndexOf: Einen zulässigen Status finden

Mit der statischen Methode `Array.IndexOf` findest du das erste Vorkommen eines Status im Array und prüfst, ob dieser Status zulässig ist.

Version: C# 12 and .NET 8; later runtimes may add compatible features

Syntax

public static int IndexOf<T>(T[] array, T value);

// With string[] AllowedStatuses and string s2:
int index = Array.IndexOf(AllowedStatuses,s2);
bool isAllowed = index >= 0;

In C# 12 unter .NET 8 durchsucht Array.IndexOf(AllowedStatuses,s2) das gesamte eindimensionale Array AllowedStatuses vom Typ string[] nach dem string-Wert s2. Die statische Methode gehört zum Typ System.Array. Der Compiler wählt die generische Überladung IndexOf<T>(T[], T) mit zwei Argumenten und leitet string für T ab. Er wählt nicht die nicht generische Überladung IndexOf(Array, object).

Die Methode liefert einen int: den bei null beginnenden Index des ersten Treffers oder -1, wenn es keinen Treffer gibt. Mit index >= 0 prüfst du, ob der Status zulässig ist, auch wenn er an erster Stelle steht. Verwende -1 nicht als Arrayindex. Ist das Array selbst null, löst die Methode ArgumentNullException aus, statt -1 zurückzugeben.

Die Methode verwendet den Standardgleichheitsvergleich für den Elementtyp. Für string ist der Vergleich ordinal und kulturunabhängig und beachtet die Groß- und Kleinschreibung. Diese Überladung akzeptiert keinen benutzerdefinierten Vergleicher.

Verwechsle diese Methode weder mit einer selbst geschriebenen Funktion namens IndexOf noch mit System.Collections.Generic.List<T>.IndexOf, das du auf einer Listeninstanz aufrufst, etwa mit list.IndexOf(s2).

Beispiele

using System;

string[] AllowedStatuses = { "open", "closed", "open" };
string s2 = "open";

int index = Array.IndexOf(AllowedStatuses,s2);
Console.WriteLine(index);
Console.WriteLine(index >= 0);

s2 = "Open";
index = Array.IndexOf(AllowedStatuses,s2);
Console.WriteLine(index);
Console.WriteLine(index >= 0);

Ergebnis

0
True
-1
False

`"open"` wird zuerst an Index `0` gefunden, daher ergibt die Bedingung `True`. Für `"Open"` gibt es keinen Treffer: Das Ergebnis ist `-1`, und die Bedingung ergibt `False`.

Zugehörige Lektionen

  • C# · Lektion 32 · Grundlagen · Version: 3

Quellen