List<T>.Item[Int32] Propriedade

Definição

Namespace:

System.Collections.Generic

Assembly:

System.Collections.dll

Origem:

List.cs

Obtém ou define o elemento no í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

O índice com base em zero do elemento a ser obtido ou definido.

Valor da propriedade

T

O elemento no índice especificado.

Implementações

Item[Int32]

Exceções

ArgumentOutOfRangeException

index é menor que 0.

- ou -

index é igual a ou maior que Count.

Exemplos

O exemplo nesta seção demonstra a Item[] propriedade (o indexador em C#) e várias outras propriedades e métodos da List<T> classe genérica. Depois que a lista for criada e preenchida usando o Add método , um elemento será recuperado e exibido usando a Item[] propriedade . (Para obter um exemplo que usa a Item[] propriedade para definir o valor de um elemento de lista, consulte AsReadOnly.)

Observação

Visual Basic, C#e C++ têm sintaxe para acessar a Item[] propriedade sem usar seu nome. Em vez disso, a variável que contém o List<T> é usada como se fosse uma matriz.

A linguagem C# usa o this palavra-chave para definir os indexadores em vez de implementar a Item[] propriedade . O Visual Basic implementa Item[] como uma propriedade padrão, que fornece a mesma funcionalidade de indexação.

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

Comentários

List<T>null aceita como um valor válido para tipos de referência e permite elementos duplicados.

Esta propriedade fornece a capacidade de acessar um elemento específico na coleção usando a seguinte sintaxe: myCollection[index].

Recuperar o valor dessa propriedade é uma operação O(1) ; definir a propriedade também é uma operação O(1).

Confira também

• Count