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