List<T>.Item[Int32] Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setDefault Public Property Item(index As Integer) As TParameter
- index
- Int32
Der nullbasierte Index des Elements, das abgerufen oder festgelegt werden soll.
Eigenschaftswert
Das Element am angegebenen Index.
Implementiert
Ausnahmen
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.
