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.

C#

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

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

Nota

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.

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

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

Aplica-se a

Confira também

• Count