List<T>.Item[Int32] Propiedad

Definición

Espacio de nombres:

System.Collections.Generic

Ensamblado:

System.Collections.dll

Source:

List.cs

Obtiene o establece el elemento en el índice especificado.

C#

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

Parámetros

index

Int32

Índice de base cero del elemento que se va a obtener o establecer.

Valor de propiedad

T

Elemento en el índice especificado.

Implementaciones

Item[Int32]

Excepciones

ArgumentOutOfRangeException

index es menor que 0.

O bien

index es igual o mayor que Count.

Ejemplos

En el ejemplo de esta sección se muestra la Item[] propiedad (el indexador en C#) y otras propiedades y métodos de la List<T> clase genérica. Una vez creada y rellenada la lista mediante el Add método , se recupera y se muestra un elemento mediante la Item[] propiedad . (Para obtener un ejemplo que usa la Item[] propiedad para establecer el valor de un elemento de lista, vea AsReadOnly).

Nota

Visual Basic, C#y C++ tienen sintaxis para acceder a la Item[] propiedad sin usar su nombre. En su lugar, la variable que contiene List<T> se usa como si fuera una matriz.

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

C#

List<string> dinosaurs = new List<string>();

Console.WriteLine("\nCapacity: {0}", dinosaurs.Capacity);

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

C#

// Shows accessing the list using the Item property.
Console.WriteLine("\ndinosaurs[3]: {0}", dinosaurs[3]);

Comentarios

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

Esta propiedad permite acceder a un elemento determinado de la colección mediante la sintaxis siguiente: myCollection[index].

Recuperar el valor de esta propiedad es una operación O(1); establecer la propiedad también es una operación O(1).

Se aplica a

Consulte también

• Count