List<T>.Item[Int32] Eigenschaft

Definition

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

Ausnahmen

index ist kleiner als 0.

- oder - index ist größer oder gleich Count.

Beispiele

Im Beispiel in diesem Abschnitt wird die Item[] Eigenschaft (der Indexer in C#) und verschiedene andere Eigenschaften und Methoden der List<T> generischen Klasse veranschaulicht. Nachdem die Liste mithilfe der Methode erstellt und aufgefüllt wurde, wird ein Element abgerufen und mithilfe der Add Item[] Eigenschaft angezeigt. (Beispiel, das die Item[] Eigenschaft verwendet, um den Wert eines Listenelements festzulegen, siehe 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 dies List<T> enthält, als wäre es ein Array.

Die C#-Sprache verwendet das Schlüsselwort, um die this Indexer zu definieren, 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 Referenztypen und ermöglicht doppelte Elemente.

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

Gilt für

Siehe auch