Item (Propiedad)

Collection<T>.Item (Propiedad)

Obtiene o establece el elemento que se encuentra en el índice especificado.

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

public T this[
	int index
] { get; set; }

Parámetros

index
Tipo: System.Int32
Índice de base cero del elemento que se va a obtener o establecer.

Valor de propiedad

Tipo: T
Elemento situado en el índice especificado.

Implementaciones

IList<T>.Item[Int32]

ExcepciónCondición
ArgumentOutOfRangeException

El valor del parámetro index es menor que cero.

-o-

index es mayor o igual que Count.

Collection<T> acepta null como valor válido para los tipos de referencia y permite elementos duplicados.

Esta propiedad permite obtener acceso a un elemento específico de la colección utilizando la sintaxis siguiente: myCollection[index].

El lenguaje C# utiliza la palabra clave this para definir los indizadores en lugar de implementar la propiedad Item. Visual Basic implementa Item como propiedad predeterminada, lo que proporciona la misma funcionalidad de indización.

La recuperación del valor de esta propiedad es una operación O(1); el establecimiento de la propiedad también es una operación O(1).

Notas para los herederos

Las clases derivadas pueden reemplazar el método SetItem para cambiar el comportamiento que produce el establecimiento de esta propiedad.

En el ejemplo de código siguiente se muestran muchos métodos y propiedades de Collection<T>. 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
 */


.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Compatible con:

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2016 Microsoft