List<T>.Item[Int32] Vlastnost

Definice

Obor názvů:

System.Collections.Generic

Sestavení:

System.Collections.dll

Zdroj:

List.cs

Získá nebo nastaví prvek u zadaného indexu.

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

Index prvku založený na nule, který se má získat nebo nastavit.

Hodnota vlastnosti

T

Prvek na pozici zadaného indexu.

Implementuje

Item[Int32]

Výjimky

ArgumentOutOfRangeException

index je menší než 0.

-nebo-

index je rovno nebo větší než Count.

Příklady

Příklad v této části ukazuje Item[] vlastnost (indexer v jazyce C#) a různé další vlastnosti a metody List<T> obecné třídy. Po vytvoření a naplnění seznamu pomocí Add metody se prvek načte a zobrazí pomocí Item[] vlastnosti . (Příklad, který používá Item[] vlastnost k nastavení hodnoty prvku list, najdete v tématu AsReadOnly.)

Poznámka

Visual Basic, C# a C++ mají syntaxi pro přístup k Item[] vlastnosti bez použití jejího názvu. Místo toho se proměnná obsahující List<T> hodnotu použije, jako by se jednalo o pole.

Jazyk C# používá this klíčové slovo k definování indexerů místo implementace Item[] vlastnosti. Visual Basic se implementuje Item[] jako výchozí vlastnost, která poskytuje stejné funkce indexování.

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))

Poznámky

List<T> přijímá null jako platnou hodnotu pro odkazové typy a umožňuje duplicitní elementy.

Tato vlastnost poskytuje možnost přístupu ke konkrétnímu prvku v kolekci pomocí následující syntaxe: myCollection[index].

Načtení hodnoty této vlastnosti je operace O(1); nastavení vlastnosti je také operace O(1).

Viz také

• Count