List<T>.Item[Int32] Egenskap

Definition

Namnområde:
System.Collections.Generic
Sammansättningar:
mscorlib.dll, System.Collections.dll
Sammansättning:
mscorlib.dll
Sammansättning:
System.Collections.dll
Sammansättning:
netstandard.dll

Hämtar eller anger elementet vid det angivna indexet.

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

Parametrar

index
Int32

Det nollbaserade indexet för det element som ska hämtas eller anges.

Egenskapsvärde

T

Elementet i det angivna indexet.

Implementeringar

Item[Int32]

Undantag

ArgumentOutOfRangeException

index är mindre än 0.

-eller-

index är lika med eller större än Count.

Exempel

Exemplet i det här avsnittet visar Item[] egenskapen (indexeraren i C#) och olika andra egenskaper och metoder för den List<T> generiska klassen. När listan har skapats och fyllts i med metoden Add hämtas ett element och visas med hjälp av Item[] egenskapen . (Ett exempel som använder Item[] egenskapen för att ange värdet för ett listelement finns i AsReadOnly.)

Note

Visual Basic, C# och C++ har alla syntax för åtkomst till egenskapen Item[] utan att använda dess namn. I stället används variabeln List<T> som innehåller den som om den vore en matris.

C#-språket använder nyckelordet this för att definiera indexerarna i stället för att Item[] implementera egenskapen. Visual Basic implementerar Item[] som en standardegenskap, vilket ger samma indexeringsfunktioner.

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

Kommentarer

List<T> null accepterar som ett giltigt värde för referenstyper och tillåter duplicerade element.

Den här egenskapen ger möjlighet att komma åt ett specifikt element i samlingen med hjälp av följande syntax: myCollection[index].

Att hämta värdet för den här egenskapen är en O(1)-åtgärd. inställningen av egenskapen är också en O(1)-åtgärd.

Gäller för

Se även