Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

Array.IndexOf: wyszukiwanie dozwolonego statusu

Użyj statycznej metody `Array.IndexOf`, aby znaleźć pierwsze wystąpienie statusu w tablicy i sprawdzić, czy należy on do dozwolonych wartości.

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

Składnia

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;

W C# 12 i .NET 8 wywołanie Array.IndexOf(AllowedStatuses,s2) przeszukuje całą jednowymiarową tablicę AllowedStatuses typu string[] w poszukiwaniu wartości s2 typu string. Jest to statyczna metoda typu System.Array. Kompilator wybiera dwuargumentowe przeciążenie generyczne IndexOf<T>(T[], T) i wnioskuje, że T to string. Nie wybiera przeciążenia niegenerycznego IndexOf(Array, object).

Metoda zwraca int: indeks pierwszego dopasowania liczony od zera albo -1, jeśli nie ma dopasowania. index >= 0 sprawdza, czy status jest dozwolony, również wtedy, gdy znajduje się na pierwszej pozycji. Nie używaj -1 jako indeksu tablicy. Jeśli sama tablica ma wartość null, metoda zgłasza ArgumentNullException zamiast zwrócić -1.

Metoda używa domyślnego porównywania równości dla typu elementu. Dla string porównanie jest porządkowe (ordinal), niezależne od ustawień kultury i uwzględnia wielkość liter. To przeciążenie nie przyjmuje własnego mechanizmu porównywania.

Nie myl tej metody z własną funkcją o nazwie IndexOf ani z System.Collections.Generic.List<T>.IndexOf, którą wywołuje się na instancji listy, np. list.IndexOf(s2).

Przykłady

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);

Wynik

0
True
-1
False

`"open"` pasuje po raz pierwszy pod indeksem `0`, więc warunek daje `True`. `"Open"` się nie dopasowuje, więc wynik to `-1`, a warunek daje `False`.

Powiązane lekcje

  • C# · Lekcja 32 · Podstawowy · Wersja: 3

Źródła