Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

Array.IndexOf : rechercher un statut autorisé

Utilisez la méthode statique `Array.IndexOf` pour repérer la première occurrence d’un statut dans un tableau et vérifier si ce statut est autorisé.

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

Syntaxe

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;

En C# 12 sur .NET 8, Array.IndexOf(AllowedStatuses,s2) recherche la valeur s2 de type string dans l’ensemble du tableau unidimensionnel AllowedStatuses de type string[]. Cette méthode statique appartient à System.Array. Le compilateur choisit la surcharge générique à deux arguments IndexOf<T>(T[], T) et déduit que T est string. Il ne choisit pas la surcharge non générique IndexOf(Array, object).

La méthode renvoie un int : l’indice de la première correspondance, en comptant à partir de zéro, ou -1 si aucune valeur ne correspond. Utilisez index >= 0 pour vérifier que le statut est autorisé, même s’il se trouve en première position. N’utilisez pas -1 comme indice du tableau. Si le tableau lui-même vaut null, la méthode lève ArgumentNullException au lieu de renvoyer -1.

La méthode utilise la comparaison d’égalité par défaut du type des éléments. Pour string, la comparaison est ordinale, indépendante de la culture et sensible à la casse. Cette surcharge n’accepte pas de comparateur personnalisé.

Ne confondez pas cette méthode avec une fonction IndexOf que vous écrivez vous-même, ni avec System.Collections.Generic.List<T>.IndexOf, qui s’appelle sur une instance de liste, par exemple list.IndexOf(s2).

Exemples

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

Résultat

0
True
-1
False

La première correspondance pour `"open"` se trouve à l’indice `0` : la condition donne `True`. Aucune valeur ne correspond à `"Open"` : le résultat est `-1` et la condition donne `False`.

Leçons associées

  • C# · Leçon 32 · Débutant · Version : 3

Sources