Partilhar via


List<T>.IndexOf Método

Definição

Retorna o índice baseado em zero da primeira ocorrência de um valor no List<T> ou em uma parte dele.

Sobrecargas

IndexOf(T, Int32)

Procura o objeto especificado e retorna o índice baseado em zero da primeira ocorrência dentro do intervalo de elementos em List<T> que se estende do índice especificado para o último elemento.

IndexOf(T, Int32, Int32)

Pesquisa o objeto especificado e retorna o índice baseado em zero da primeira ocorrência em um intervalo de elementos no List<T> que começa no índice especificado e contém o número de elementos especificado.

IndexOf(T)

Pesquisa o objeto especificado e retorna o índice baseado em zero da primeira ocorrência dentro de todo o List<T>.

Exemplos

O exemplo a seguir demonstra todas as três sobrecargas do IndexOf método . Um List<T> de cadeias de caracteres é criado, com uma entrada que aparece duas vezes, no local do índice 0 e no local do índice 5. A IndexOf(T) sobrecarga do método pesquisa a lista desde o início e localiza a primeira ocorrência da cadeia de caracteres. A IndexOf(T, Int32) sobrecarga do método é usada para pesquisar a lista começando com o local do índice 3 e continuando até o final da lista e localiza a segunda ocorrência da cadeia de caracteres. Por fim, a sobrecarga do IndexOf(T, Int32, Int32) método é usada para pesquisar um intervalo de duas entradas, começando no local do índice dois; ele retorna -1 porque não há instâncias da cadeia de caracteres de pesquisa nesse intervalo.

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)

Origem:
List.cs
Origem:
List.cs
Origem:
List.cs

Procura o objeto especificado e retorna o índice baseado em zero da primeira ocorrência dentro do intervalo de elementos em List<T> que se estende do índice especificado para o último elemento.

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

Parâmetros

item
T

O objeto a ser localizado no List<T>. O valor pode ser null para tipos de referência.

index
Int32

O índice inicial com base em zero da pesquisa. 0 (zero) é válido em uma lista vazia.

Retornos

O índice baseado em zero da primeira ocorrência de item dentro do intervalo de elementos no List<T> que se estende do index ao último elemento, se for encontrado; caso contrário, -1.

Exceções

index está fora do intervalo de índices válidos para o List<T>.

Comentários

O List<T> é pesquisado para frente começando em index e terminando no último elemento.

Esse método determina a igualdade usando o comparador EqualityComparer<T>.Default de igualdade padrão para T, o tipo de valores na lista.

Esse método executa uma pesquisa linear; portanto, esse método é uma operação O(n), em que n é o número de elementos de index até o final do List<T>.

Confira também

Aplica-se a

IndexOf(T, Int32, Int32)

Origem:
List.cs
Origem:
List.cs
Origem:
List.cs

Pesquisa o objeto especificado e retorna o índice baseado em zero da primeira ocorrência em um intervalo de elementos no List<T> que começa no índice especificado e contém o número de elementos especificado.

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

Parâmetros

item
T

O objeto a ser localizado no List<T>. O valor pode ser null para tipos de referência.

index
Int32

O índice inicial com base em zero da pesquisa. 0 (zero) é válido em uma lista vazia.

count
Int32

O número de elementos na seção a ser pesquisada.

Retornos

O índice baseado em zero da primeira ocorrência de item dentro do intervalo de elementos no List<T> que começa em index e contém o número de elementos count, se encontrado; caso contrário, -1.

Exceções

index está fora do intervalo de índices válidos para o List<T>.

- ou -

count é menor que 0.

- ou -

index e count não especificam uma seção válida no List<T>.

Comentários

O List<T> é pesquisado para frente começando em index e terminando em index mais count menos 1, se count for maior que 0.

Esse método determina a igualdade usando o comparador EqualityComparer<T>.Default de igualdade padrão para T, o tipo de valores na lista.

Esse método executa uma pesquisa linear; portanto, esse método é uma operação O(n), em que n é count.

Confira também

Aplica-se a

IndexOf(T)

Origem:
List.cs
Origem:
List.cs
Origem:
List.cs

Pesquisa o objeto especificado e retorna o índice baseado em zero da primeira ocorrência dentro de todo o List<T>.

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

Parâmetros

item
T

O objeto a ser localizado no List<T>. O valor pode ser null para tipos de referência.

Retornos

O índice baseado em zero da primeira ocorrência de item em todo o List<T>, se encontrado; caso contrário, -1.

Implementações

Comentários

O List<T> é pesquisado para frente começando no primeiro elemento e terminando no último elemento.

Esse método determina a igualdade usando o comparador EqualityComparer<T>.Default de igualdade padrão para T, o tipo de valores na lista.

Esse método executa uma pesquisa linear; portanto, esse método é uma operação O(n), em que n é Count.

Confira também

Aplica-se a