List<T>.Item[Int32] Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает элемент по указанному индексу.
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, setDefault Public Property Item(index As Integer) As TПараметры
- index
- Int32
Отсчитываемый от нуля индекс элемента, который требуется возвратить или задать.
Значение свойства
Элемент, расположенный по указанному индексу.
Реализации
Исключения
Значение параметра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).
