List<T>.IndexOf Methode

Referenz

Definition

Namespace:: System.Collections.Generic

Assembly:: System.Collections.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt den nullbasierten Index des ersten Vorkommens eines Werts in der List<T> bzw. in einem Abschnitt davon zurück.

Überlädt

IndexOf(T, Int32)	Sucht nach dem angegebenen Objekt und gibt den nullbasierten Index des ersten Vorkommens innerhalb des Bereichs von Elementen in der List<T> zurück, der sich vom angegebenen Index bis zum letzten Element erstreckt.
IndexOf(T, Int32, Int32)	Sucht nach dem angegebenen Objekt und gibt den nullbasierten Index des ersten Vorkommens innerhalb des Bereichs von Elementen in der List<T> zurück, der am angegebenen Index beginnt und die angegebene Anzahl von Elementen enthält.
IndexOf(T)	Sucht nach dem angegebenen Objekt und gibt den nullbasierten Index des ersten Vorkommens innerhalb der gesamten List<T> zurück.

Beispiele

Im folgenden Beispiel werden alle drei Überladungen der IndexOf Methode veranschaulicht. Eine List<T> von Zeichenfolgen wird erstellt, wobei ein Eintrag zweimal an Indexposition 0 und Indexspeicherort 5 angezeigt wird. Die IndexOf(T) Methodenüberladung durchsucht die Liste von Anfang an und findet das erste Vorkommen der Zeichenfolge. Die IndexOf(T, Int32) Methodenüberladung wird verwendet, um die Liste ab Indexspeicherort 3 und weiter bis zum Ende der Liste zu durchsuchen und das zweite Vorkommen der Zeichenfolge zu finden. Schließlich wird die IndexOf(T, Int32, Int32) Methodenüberladung verwendet, um einen Bereich von zwei Einträgen zu durchsuchen, beginnend am Indexspeicherort 2. Sie gibt -1 zurück, da es in diesem Bereich keine Instanzen der Suchzeichenfolge gibt.

using namespace System;
using namespace System::Collections::Generic;

void main()
{
    List<String^>^ dinosaurs = gcnew List<String^>();

    dinosaurs->Add("Tyrannosaurus");
    dinosaurs->Add("Amargasaurus");
    dinosaurs->Add("Mamenchisaurus");
    dinosaurs->Add("Brachiosaurus");
    dinosaurs->Add("Deinonychus");
    dinosaurs->Add("Tyrannosaurus");
    dinosaurs->Add("Compsognathus");

    Console::WriteLine();
    for each(String^ dinosaur in dinosaurs )
    {
        Console::WriteLine(dinosaur);
    }

    Console::WriteLine("\nIndexOf(\"Tyrannosaurus\"): {0}", 
        dinosaurs->IndexOf("Tyrannosaurus"));

    Console::WriteLine("\nIndexOf(\"Tyrannosaurus\", 3): {0}", 
        dinosaurs->IndexOf("Tyrannosaurus", 3));

    Console::WriteLine("\nIndexOf(\"Tyrannosaurus\", 2, 2): {0}", 
        dinosaurs->IndexOf("Tyrannosaurus", 2, 2));
}

/* This code example produces the following output:

Tyrannosaurus
Amargasaurus
Mamenchisaurus
Brachiosaurus
Deinonychus
Tyrannosaurus
Compsognathus

IndexOf("Tyrannosaurus"): 0

IndexOf("Tyrannosaurus", 3): 5

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

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        List<string> dinosaurs = new List<string>();

        dinosaurs.Add("Tyrannosaurus");
        dinosaurs.Add("Amargasaurus");
        dinosaurs.Add("Mamenchisaurus");
        dinosaurs.Add("Brachiosaurus");
        dinosaurs.Add("Deinonychus");
        dinosaurs.Add("Tyrannosaurus");
        dinosaurs.Add("Compsognathus");

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

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

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

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

/* This code example produces the following output:

Tyrannosaurus
Amargasaurus
Mamenchisaurus
Brachiosaurus
Deinonychus
Tyrannosaurus
Compsognathus

IndexOf("Tyrannosaurus"): 0

IndexOf("Tyrannosaurus", 3): 5

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

Imports System.Collections.Generic

Public Class Example

    Public Shared Sub Main()

        Dim dinosaurs As New List(Of String)

        dinosaurs.Add("Tyrannosaurus")
        dinosaurs.Add("Amargasaurus")
        dinosaurs.Add("Mamenchisaurus")
        dinosaurs.Add("Brachiosaurus")
        dinosaurs.Add("Deinonychus")
        dinosaurs.Add("Tyrannosaurus")
        dinosaurs.Add("Compsognathus")

        Console.WriteLine()
        For Each dinosaur As String In dinosaurs
            Console.WriteLine(dinosaur)
        Next

        Console.WriteLine(vbLf & _
            "IndexOf(""Tyrannosaurus""): {0}", _
            dinosaurs.IndexOf("Tyrannosaurus"))

        Console.WriteLine(vbLf & _
            "IndexOf(""Tyrannosaurus"", 3): {0}", _
            dinosaurs.IndexOf("Tyrannosaurus", 3))

        Console.WriteLine(vbLf & _
            "IndexOf(""Tyrannosaurus"", 2, 2): {0}", _
            dinosaurs.IndexOf("Tyrannosaurus", 2, 2))

    End Sub
End Class

' This code example produces the following output:
'
'Tyrannosaurus
'Amargasaurus
'Mamenchisaurus
'Brachiosaurus
'Deinonychus
'Tyrannosaurus
'Compsognathus
'
'IndexOf("Tyrannosaurus"): 0
'
'IndexOf("Tyrannosaurus", 3): 5
'
'IndexOf("Tyrannosaurus", 2, 2): -1

IndexOf(T, Int32)

Quelle:: List.cs

Quelle:: List.cs

Quelle:: List.cs

Sucht nach dem angegebenen Objekt und gibt den nullbasierten Index des ersten Vorkommens innerhalb des Bereichs von Elementen in der List<T> zurück, der sich vom angegebenen Index bis zum letzten Element erstreckt.

public:
 int IndexOf(T item, int index);

public int IndexOf (T item, int index);

member this.IndexOf : 'T * int -> int

Public Function IndexOf (item As T, index As Integer) As Integer

Parameter

item: T

Das im List<T> zu suchende Objekt. Der Wert kann für Verweistypen null sein.

index: Int32

Der nullbasierte Startindex für die Suche. 0 (null) ist in einer leeren Liste gültig.

Gibt zurück

Int32

Der nullbasierte Index des ersten Vorkommens von item innerhalb des Bereichs von Elementen in List<T>, der sich von index bis zum letzten Element erstreckt, sofern gefunden; andernfalls –1.

Ausnahmen

ArgumentOutOfRangeException

index liegt außerhalb des Bereichs der gültigen Indizes für das List<T>.

Hinweise

Die List<T> wird nach vorne gesucht, beginnend am index und endend beim letzten Element.

Diese Methode bestimmt die Gleichheit mithilfe des Standardvergleichs EqualityComparer<T>.Default für T, dem Typ der Werte in der Liste.

Diese Methode führt eine lineare Suche durch. Daher ist diese Methode ein O(n)-Vorgang, wobei n die Anzahl der Elemente von index bis zum Ende des List<T>ist.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

IndexOf(T, Int32, Int32)

Quelle:: List.cs

Quelle:: List.cs

Quelle:: List.cs

Sucht nach dem angegebenen Objekt und gibt den nullbasierten Index des ersten Vorkommens innerhalb des Bereichs von Elementen in der List<T> zurück, der am angegebenen Index beginnt und die angegebene Anzahl von Elementen enthält.

public:
 int IndexOf(T item, int index, int count);

public int IndexOf (T item, int index, int count);

member this.IndexOf : 'T * int * int -> int

Public Function IndexOf (item As T, index As Integer, count As Integer) As Integer

Parameter

item: T

Das im List<T> zu suchende Objekt. Der Wert kann für Verweistypen null sein.

index: Int32

Der nullbasierte Startindex für die Suche. 0 (null) ist in einer leeren Liste gültig.

count: Int32

Die Anzahl der Elemente im zu durchsuchenden Abschnitt.

Gibt zurück

Int32

Der nullbasierte Index des ersten Vorkommens von item innerhalb des Bereichs von Elementen in List<T>, der am index beginnt und eine Anzahl von Elementen count enthält, sofern gefunden; andernfalls –1.

Ausnahmen

ArgumentOutOfRangeException

index liegt außerhalb des Bereichs der gültigen Indizes für das List<T>.

- oder -

count ist kleiner als 0.

- oder -

index und count geben keinen gültigen Abschnitt in der List<T> an.

Hinweise

Die List<T> wird nach vorne gesucht, beginnend bei index und endet bei index plus count minus 1, wenn count größer als 0 ist.

Diese Methode bestimmt die Gleichheit mithilfe des Standardvergleichs EqualityComparer<T>.Default für T, dem Typ der Werte in der Liste.

Diese Methode führt eine lineare Suche durch. Daher ist diese Methode ein O(n)-Vorgang, wobei n ist count.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

IndexOf(T)

Quelle:: List.cs

Quelle:: List.cs

Quelle:: List.cs

Sucht nach dem angegebenen Objekt und gibt den nullbasierten Index des ersten Vorkommens innerhalb der gesamten List<T> zurück.

public:
 virtual int IndexOf(T item);

public int IndexOf (T item);

abstract member IndexOf : 'T -> int
override this.IndexOf : 'T -> int

Public Function IndexOf (item As T) As Integer

Parameter

item: T

Das im List<T> zu suchende Objekt. Der Wert kann für Verweistypen null sein.

Gibt zurück

Int32

Der nullbasierte Index des ggf. ersten Vorkommens von item in der gesamten List<T>, andernfalls -1.

Implementiert

IndexOf(T)

Hinweise

Das List<T> wird nach vorne gesucht, beginnend mit dem ersten Element und endend mit dem letzten Element.

Diese Methode bestimmt die Gleichheit mithilfe des Standardvergleichs EqualityComparer<T>.Default für T, dem Typ der Werte in der Liste.

Diese Methode führt eine lineare Suche durch. Daher ist diese Methode ein O(n)-Vorgang, wobei n ist Count.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Freigeben über

List<T>.IndexOf Methode

Definition

Überlädt

Beispiele

IndexOf(T, Int32)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

IndexOf(T, Int32, Int32)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

IndexOf(T)

Parameter

Gibt zurück

Implementiert

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen