List<T>.Item[Int32] Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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, setDefault Public Property Item(index As Integer) As TParâmetros
- index
- Int32
O índice em base zero do elemento a obter ou definir.
Valor de Propriedade
O elemento no índice especificado.
Implementações
Exceções
Exemplos
O exemplo nesta secção demonstra a Item[] propriedade (o indexador em C#) e várias outras propriedades e métodos da List<T> classe genérica. Depois de a lista ser criada e preenchida usando o Add método, um elemento é recuperado e exibido usando a Item[] propriedade. (Para um exemplo que usa a Item[] propriedade para definir o valor de um elemento de lista, veja AsReadOnly.)
Note
Visual Basic, C# e C++ têm todos sintaxe para aceder à propriedade Item[] sem usar o seu nome. Em vez disso, a variável que contém o List<T> é usada como se fosse um array.
A linguagem C# usa a this palavra-chave para definir os indexadores em vez de implementar a propriedade Item[] . Visual Basic implementa Item[] como propriedade predefinida, 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 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))
Observações
List<T> aceita null como um valor válido para tipos de referência e permite elementos duplicados.
Esta propriedade permite aceder a um elemento específico da coleção utilizando a seguinte sintaxe: myCollection[index].
Recuperar o valor desta propriedade é uma operação O(1); definir a propriedade é também uma operação O(1).
