Esta documentación está archivada y no tiene mantenimiento.

Collection.IndexOf (Método)

Nota: este método es nuevo en la versión 2.0 de .NET Framework.

Busca el objeto especificado y devuelve el índice de base cero de la primera aparición en toda la colección Collection.

Espacio de nombres: System.Collections.ObjectModel
Ensamblado: mscorlib (en mscorlib.dll)

public int IndexOf (
	T item
)
public final int IndexOf (
	T item
)
public final function IndexOf (
	item : T
) : int

Parámetros

item

Objeto que se va a buscar en List. El valor puede ser referencia de objeto null (Nothing en Visual Basic) para los tipos de referencia.

Valor devuelto

Índice de base cero de la primera aparición de item en la totalidad de Collection, si se encuentra; en caso contrario, -1.

La búsqueda en Collection se realiza hacia delante, empezando por el primer elemento y terminando en el último.

Este método determina la igualdad mediante el comparador predeterminado Comparer.Default. Comparer.Default comprueba si el tipo T implementa System.IComparable y utiliza esa implementación, si está disponible. En caso contrario, Comparer.Default comprueba si el tipo T implementa System.IComparable. Si el tipo T no implementa una u otra interfaz, el método utiliza System.Object.Equals.

Este método realiza una búsqueda lineal, por lo que el tiempo medio de ejecución es proporcional a Count. Es decir, el método es una operación O(n), donde n es Count.

En el ejemplo de código siguiente se muestran muchos métodos y propiedades de Collection. En este ejemplo de código se crea una colección de cadenas, se utiliza el método Add para agregar varias cadenas, se muestra Count y se confecciona una lista de las cadenas. También se utiliza el método IndexOf para localizar el índice de una cadena y el método Contains para determinar si una cadena se encuentra en la colección. En el ejemplo se inserta una cadena mediante el método Insert y se recuperan y establecen cadenas mediante la propiedad Item predeterminada (el indizador en C#). Se quitan cadenas a partir de la identidad de cadena, utilizando el método Remove, y a partir del índice, utilizando el método RemoveAt. Por último, se usa el método Clear para borrar todas las cadenas de la colección.

using System;
using System.Collections.Generic;
using System.Collections.ObjectModel;

public class Demo
{
    public static void Main()
    {
        Collection<string> dinosaurs = new Collection<string>();

        dinosaurs.Add("Psitticosaurus");
        dinosaurs.Add("Caudipteryx");
        dinosaurs.Add("Compsognathus");
        dinosaurs.Add("Muttaburrasaurus");

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

        Console.WriteLine("\nContains(\"Caudipteryx\"): {0}", 
            dinosaurs.Contains("Caudipteryx"));

        Console.WriteLine("\nInsert(2, \"Nanotyrannus\")");
        dinosaurs.Insert(2, "Nanotyrannus");
        Display(dinosaurs);

        Console.WriteLine("\ndinosaurs[2]: {0}", dinosaurs[2]);

        Console.WriteLine("\ndinosaurs[2] = \"Microraptor\"");
        dinosaurs[2] = "Microraptor";
        Display(dinosaurs);

        Console.WriteLine("\nRemove(\"Microraptor\")");
        dinosaurs.Remove("Microraptor");
        Display(dinosaurs);

        Console.WriteLine("\nRemoveAt(0)");
        dinosaurs.RemoveAt(0);
        Display(dinosaurs);

        Console.WriteLine("\ndinosaurs.Clear()");
        dinosaurs.Clear();
        Console.WriteLine("Count: {0}", dinosaurs.Count);
    }
    
    private static void Display(Collection<string> cs)
    {
        Console.WriteLine();
        foreach( string item in cs )
        {
            Console.WriteLine(item);
        }
    }
}

/* This code example produces the following output:

4 dinosaurs:

Psitticosaurus
Caudipteryx
Compsognathus
Muttaburrasaurus

IndexOf("Muttaburrasaurus"): 3

Contains("Caudipteryx"): True

Insert(2, "Nanotyrannus")

Psitticosaurus
Caudipteryx
Nanotyrannus
Compsognathus
Muttaburrasaurus

dinosaurs[2]: Nanotyrannus

dinosaurs[2] = "Microraptor"

Psitticosaurus
Caudipteryx
Microraptor
Compsognathus
Muttaburrasaurus

Remove("Microraptor")

Psitticosaurus
Caudipteryx
Compsognathus
Muttaburrasaurus

RemoveAt(0)

Caudipteryx
Compsognathus
Muttaburrasaurus

dinosaurs.Clear()
Count: 0
 */

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

Compatible con: 2.0

.NET Compact Framework

Compatible con: 2.0
Mostrar: