List<T>.Item[Int32] Eigenschaft

Definition

Namespace:

System.Collections.Generic

Assembly:

System.Collections.dll

Quelle:

List.cs

Ruft das Element am angegebenen Index ab oder legt dieses fest.

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

Parameter

index

Int32

Der nullbasierte Index des Elements, das abgerufen oder festgelegt werden soll.

Eigenschaftswert

T

Das Element am angegebenen Index.

Implementiert

Item[Int32]

Ausnahmen

ArgumentOutOfRangeException

index ist kleiner als 0.

- oder -

index ist größer oder gleich Count.

Beispiele

Das Beispiel in diesem Abschnitt veranschaulicht die Item[] Eigenschaft (der Indexer in C#) und verschiedene andere Eigenschaften und Methoden der List<T> generischen Klasse. Nachdem die Liste mit der Add -Methode erstellt und aufgefüllt wurde, wird ein Element abgerufen und mithilfe der Item[] -Eigenschaft angezeigt. (Ein Beispiel, das die Item[] -Eigenschaft verwendet, um den Wert eines Listenelements festzulegen, finden Sie unter AsReadOnly.)

Hinweis

Visual Basic, C# und C++ verfügen alle über Syntax für den Zugriff auf die Item[] Eigenschaft, ohne ihren Namen zu verwenden. Stattdessen wird die Variable, die das List<T> enthält, wie ein Array verwendet.

Die Programmiersprache C# verwendet für die Definition der Indexer das this-Schlüsselwort, anstatt die Item[]-Eigenschaft zu implementieren. Visual Basic implementiert Item[] als Standardeigenschaft und stellt auf diese Weise dieselbe Indizierungsfunktionalität bereit.

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

Hinweise

List<T> akzeptiert null als gültiger Wert für Verweistypen und lässt doppelte Elemente zu.

Über diese Eigenschaft können Sie mithilfe der folgenden Syntax auf ein bestimmtes Element der Auflistung zugreifen: myCollection[index].

Das Abrufen des Werts dieser Eigenschaft ist ein O(1)-Vorgang. Das Festlegen der Eigenschaft ist auch ein O(1)-Vorgang.

Weitere Informationen

• Count