List<T>.Item[Int32] Eigenschap

Definitie

Hiermee haalt u het element op de opgegeven index op of stelt u het in.

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

Parameters

index
Int32

De op nul gebaseerde index van het element om op te halen of in te stellen.

Waarde van eigenschap

T

Het element in de opgegeven index.

Implementeringen

Uitzonderingen

index is kleiner dan 0.

– of –

index is gelijk aan of groter dan Count.

Voorbeelden

In het voorbeeld in deze sectie ziet u de Item[] eigenschap (de indexeerfunctie in C#) en verschillende andere eigenschappen en methoden van de List<T> algemene klasse. Nadat de lijst is gemaakt en ingevuld met behulp van de Add methode, wordt een element opgehaald en weergegeven met behulp van de Item[] eigenschap. (Zie .) Voor een voorbeeld waarin de Item[] eigenschap wordt gebruikt om de waarde van een lijstelement in te stellen, raadpleegt AsReadOnlyu .)

Note

Visual Basic, C# en C++ hebben allemaal syntaxis voor toegang tot de eigenschap Item[] zonder de naam te gebruiken. In plaats daarvan wordt de variabele die de List<T> variabele bevat, gebruikt alsof het een matrix is.

De C#-taal gebruikt het this trefwoord om de indexeerfuncties te definiëren in plaats van de Item[] eigenschap te implementeren. Visual Basic implementeert Item[] als een standaardeigenschap, die dezelfde indexeringsfunctionaliteit biedt.

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

Opmerkingen

List<T> accepteert null als een geldige waarde voor referentietypen en staat dubbele elementen toe.

Deze eigenschap biedt de mogelijkheid om toegang te krijgen tot een specifiek element in de verzameling met behulp van de volgende syntaxis: myCollection[index]

Het ophalen van de waarde van deze eigenschap is een O(1)-bewerking; het instellen van de eigenschap is ook een O(1)-bewerking.

Van toepassing op

Zie ook