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 es 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 mithilfe der Add Methode erstellt und aufgefüllt wurde, wird ein Element mithilfe der Item[] Eigenschaft abgerufen und angezeigt. (Ein Beispiel, das die Item[] Eigenschaft zum Festlegen des Werts eines Listenelements verwendet, finden Sie unter AsReadOnly.)
Anmerkung
Visual Basic, C# und C++ verfügen alle über eine Syntax für den Zugriff auf die eigenschaft Item[], ohne den Namen zu verwenden. Stattdessen wird die Variable, die die List<T> Zeichenfolge enthält, verwendet, als wäre sie ein Array.
Die C#-Sprache verwendet das this Schlüsselwort, um die Indexer zu definieren, anstatt die Item[] Eigenschaft zu implementieren. Visual Basic wird als Standardeigenschaft implementiert Item[] , die die gleiche Indizierungsfunktion bereitstellt.
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))
Hinweise
List<T> akzeptiert null als gültiger Wert für Bezugstypen und lässt doppelte Elemente zu.
Diese Eigenschaft bietet die Möglichkeit, mithilfe der folgenden Syntax auf ein bestimmtes Element in der Auflistung zuzugreifen: myCollection[index]
Das Abrufen des Werts dieser Eigenschaft ist ein O(1)-Vorgang; Das Festlegen der Eigenschaft ist auch ein O(1)-Vorgang.