Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Array.IndexOf<T> méthode (T[], T, Int32, Int32)

 

Date de publication : novembre 2016

Recherche l'objet spécifié dans une plage d'éléments d'un tableau unidimensionnel, et retourne l'index de sa première occurrence. La plage commence à un index spécifié pour un nombre d'éléments spécifié.

Espace de noms:   System
Assembly:  mscorlib (dans mscorlib.dll)

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

Paramètres

array
Type: T[]

Le tableau de base zéro unidimensionnel à explorer.

value
Type: T

Objet à rechercher dans array.

startIndex
Type: System.Int32

Index de début de base zéro de la recherche. 0 (zéro) est valide dans un tableau vide.

count
Type: System.Int32

Nombre d'éléments contenus dans la section où la recherche doit être effectuée.

Valeur de retour

Type: System.Int32

Index de base zéro de la première occurrence de value dans la plage d’éléments de l’array qui commence à startIndex et qui contient le nombre d’éléments count spécifié, s’il existe ; sinon, -1.

Paramètres de type

T

Type des éléments du tableau.

Exception Condition
ArgumentNullException

array a la valeur null.

ArgumentOutOfRangeException

startIndex n’est pas compris dans la plage d’index valides pour array.

ou

count est inférieur à zéro.

ou

startIndex et count ne spécifient pas une section valide dans array.

Cette éléments searchesthe de méthode d’un tableau unidimensionnel à partir de startIndex à startIndex plus count -1, si count est supérieur à 0. Pour déterminer si value existe dans array, la méthode effectue une comparaison d’égalité en appelant le T.Equals méthode sur chaque élément. Cela signifie que si T remplace la Equals méthode, ce remplacement est appelé.

Si startIndex égal à Array.Length, la méthode retourne -1. Si startIndex est supérieur à Array.Length, la méthode lève un ArgumentOutOfRangeException.

Cette méthode est un O (n) opération, où n est count.

L’exemple suivant illustre les trois surcharges génériques de la IndexOf (méthode). Un tableau de chaînes est créé, avec une entrée qui apparaît deux fois, à l’emplacement d’index 0 et l’emplacement d’index 5. Le IndexOf<T>(T[], T) surcharge de méthode de recherche dans le tableau à partir du début et de la première occurrence de la chaîne. Le IndexOf<T>(T[], T, Int32) surcharge de méthode est utilisée pour rechercher le tableau en commençant par l’emplacement d’index 3 et en continuant à la fin du tableau et la deuxième occurrence de la chaîne. Enfin, le IndexOf<T>(T[], T, Int32, Int32)surcharge de méthode est utilisée pour rechercher une plage de deux entrées, en commençant à l’emplacement d’index deux ; elle retourne – 1, car il n’existe aucune instance de la chaîne de recherche dans cette plage.

using System;

public class Example
{
    public static void Main()
    {
        string[] dinosaurs = { "Tyrannosaurus",
            "Amargasaurus",
            "Mamenchisaurus",
            "Brachiosaurus",
            "Deinonychus",
            "Tyrannosaurus",
            "Compsognathus" };

        Console.WriteLine();
        foreach(string dinosaur in dinosaurs)
        {
            Console.WriteLine(dinosaur);
        }

        Console.WriteLine(
            "\nArray.IndexOf(dinosaurs, \"Tyrannosaurus\"): {0}", 
            Array.IndexOf(dinosaurs, "Tyrannosaurus"));

        Console.WriteLine(
            "\nArray.IndexOf(dinosaurs, \"Tyrannosaurus\", 3): {0}", 
            Array.IndexOf(dinosaurs, "Tyrannosaurus", 3));

        Console.WriteLine(
            "\nArray.IndexOf(dinosaurs, \"Tyrannosaurus\", 2, 2): {0}", 
            Array.IndexOf(dinosaurs, "Tyrannosaurus", 2, 2));
    }
}

/* This code example produces the following output:

Tyrannosaurus
Amargasaurus
Mamenchisaurus
Brachiosaurus
Deinonychus
Tyrannosaurus
Compsognathus

Array.IndexOf(dinosaurs, "Tyrannosaurus"): 0

Array.IndexOf(dinosaurs, "Tyrannosaurus", 3): 5

Array.IndexOf(dinosaurs, "Tyrannosaurus", 2, 2): -1
 */

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 2.0
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: