List<T>.Item[Int32] Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia element w określonym indeksie.
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
Parametry
- index
- Int32
Indeks zerowy elementu do pobrania lub ustawienia.
Wartość właściwości
Element w określonym indeksie.
Implementuje
Wyjątki
Przykłady
W przykładzie w tej sekcji przedstawiono Item[] właściwość (indeksator w języku C#) oraz różne inne właściwości i metody List<T> klasy ogólnej. Po utworzeniu i wypełnieniu listy przy użyciu Add metody element zostanie pobrany i wyświetlony przy użyciu Item[] właściwości . (Przykład, który używa Item[] właściwości do ustawienia wartości elementu listy, zobacz AsReadOnly.
Note
Visual Basic, C# i C++ mają składnię uzyskiwania dostępu do właściwości Item[] bez używania jej nazwy. Zamiast tego zmienna zawierająca List<T> zmienną jest używana tak, jakby była tablicą.
Język C# używa słowa kluczowego this do zdefiniowania indeksatorów zamiast implementowania Item[] właściwości. Język Visual Basic implementuje Item[] jako właściwość domyślną, która zapewnia tę samą funkcję indeksowania.
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))
Uwagi
List<T> akceptuje null jako prawidłową wartość dla typów odwołań i zezwala na zduplikowane elementy.
Ta właściwość umożliwia dostęp do określonego elementu w kolekcji przy użyciu następującej składni: myCollection[index].
Pobieranie wartości tej właściwości jest operacją O(1). ustawienie właściwości jest również operacją O(1).