List<T>.Item[Int32] Propiedad

Definición

Espacio de nombres:
System.Collections.Generic
Ensamblados:
mscorlib.dll, System.Collections.dll
Ensamblados:
netstandard.dll, System.Collections.dll
Ensamblado:
System.Collections.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll
Source:
List.cs
Source:
List.cs
Source:
List.cs
Source:
List.cs
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).

Note

Visual Basic, C#y C++ tienen sintaxis para acceder a la propiedad /> List<T> se usa como si fuera una matriz.

El lenguaje C# usa la this palabra clave para definir los indexadores en lugar de implementar la Item[] propiedad . Visual Basic implementa Item[] como una propiedad predeterminada, que proporciona la misma funcionalidad de indexació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 planets As New List(Of String)

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

planets.Add("Mercury")
planets.Add("Venus")
planets.Add("Earth")
planets.Add("Mars")
planets.Add("Jupiter")

// 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 & "planets(3): {0}", planets(3))

Comentarios

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

Esta propiedad proporciona la capacidad de acceder a un elemento específico 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