List<T>.IndexOf Método

Definição

Namespace:

System.Collections.Generic

Assembly:

System.Collections.dll

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.

C#

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
 */

IndexOf(T, Int32)

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.

C#

public int IndexOf (T item, int index);

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

Int32

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

ArgumentOutOfRangeException

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

• LastIndexOf(T)
• Contains(T)
• Executando operações de cadeia de caracteres Culture-Insensitive em coleções

IndexOf(T, Int32, Int32)

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.

C#

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

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

Int32

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

ArgumentOutOfRangeException

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

• LastIndexOf(T)
• Contains(T)
• Executando operações de cadeia de caracteres Culture-Insensitive em coleções

IndexOf(T)

Origem:

List.cs

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

C#

public int IndexOf (T item);

Parâmetros

item

T

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

Retornos

Int32

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

Implementações

IndexOf(T)

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

• LastIndexOf(T)
• Contains(T)
• Executando operações de cadeia de caracteres Culture-Insensitive em coleções