List<T>.Item[Int32] Właściwość

Definicja

Przestrzeń nazw:

System.Collections.Generic

Zestaw:

System.Collections.dll

Źródło:

List.cs

Pobiera lub ustawia element pod określonym indeksem.

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

Liczony od zera indeks elementu do pobrania lub ustawienia.

Wartość właściwości

T

Element pod określonym indeksem.

Implementuje

Item[Int32]

Wyjątki

ArgumentOutOfRangeException

index wartość jest mniejsza niż 0.

-lub-

index jest równe lub większe niż Count.

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.

Uwaga

Wszystkie języki Visual Basic, C# i C++ mają składnię umożliwiającą Item[] uzyskiwanie dostępu do właściwości 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 definiowania 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 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))

Uwagi

List<T>null akceptuje 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).

Zobacz też

• Count