List<T>.Item[Int32] Свойство

Определение

Пространство имен:

System.Collections.Generic

Сборка:

System.Collections.dll

Сборка:

mscorlib.dll

Сборка:

netstandard.dll

Возвращает или задает элемент по указанному индексу.

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

Параметры

index

Int32

Отсчитываемый от нуля индекс элемента, который требуется возвратить или задать.

Значение свойства

T

Элемент, расположенный по указанному индексу.

Реализации

Item[Int32]

Исключения

ArgumentOutOfRangeException

Значение параметраindex меньше 0.

-или- Значение параметра index больше или равно значению свойства Count.

Примеры

В примере в этом разделе показано Item[] свойство (индексатор в C#) и другие свойства и методы универсального List<T> класса. После создания и заполнения списка с помощью Add метода элемент извлекается и отображается с помощью Item[] свойства. (Пример, использующий Item[] свойство для задания значения элемента списка, см. в разделе AsReadOnly.)

Примечание

Visual Basic, C# и C++ имеют синтаксис для доступа к свойству Item[] без использования его имени. Вместо этого переменная, содержащая объект List<T> , используется так, как если бы это был массив.

Язык C# использует ключевое this слово для определения индексаторов вместо реализации Item[] свойства. В языке Visual Basic в качестве свойства по умолчанию реализовано свойство Item[], предоставляющее те же возможности индексирования.

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

Комментарии

List<T> принимает null в качестве допустимого значения для ссылочных типов и позволяет дублировать элементы.

Это свойство предоставляет доступ к указанному элементу коллекции при использовании следующего синтаксиса: myCollection[index].

Получение значения этого свойства является операцией O(1); задание свойства также является операцией O(1).

См. также раздел

• Count