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.

public:
 property T default[int] { T get(int index); void set(int index, T value); };

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

member this.Item(int) : 'T with get, set

Default Public Property Item(index As Integer) As T

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.

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");

Dim dinosaurs As New List(Of String)

Console.WriteLine(vbLf & "Capacity: {0}", dinosaurs.Capacity)

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

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

' Shows how to access the list using the Item property.
Console.WriteLine(vbLf & "dinosaurs(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).

Consulte también

• Count