List<T>.Item[Int32] List<T>.Item[Int32] List<T>.Item[Int32] List<T>.Item[Int32] Property

Определение

Возвращает или задает элемент по указанному индексу.Gets or sets the element at the specified index.

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

Отсчитываемый от нуля индекс элемента, который требуется возвратить или задать.The zero-based index of the element to get or set.

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

T T T T

Элемент, расположенный по указанному индексу.The element at the specified index.

Реализации

Исключения

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

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

Примеры

Пример в этом разделе демонстрирует Item[Int32] свойство (индексатор в C#) и различные другие свойства List<T> и методы универсального класса.The example in this section demonstrates the Item[Int32] property (the indexer in C#) and various other properties and methods of the List<T> generic class. После того как список создан и заполнен с помощью Add метода, элемент извлекается и отображается Item[Int32] с помощью свойства.After the list has been created and populated using the Add method, an element is retrieved and displayed using the Item[Int32] property. (Пример, использующий Item[Int32] свойство для задания значения элемента списка, см. в разделе AsReadOnly.)(For an example that uses the Item[Int32] property to set the value of a list element, see AsReadOnly.)

Примечание

Visual Basic, C#и C++ имеют синтаксис Item[Int32] для доступа к свойству без использования его имени.Visual Basic, C#, and C++ all have syntax for accessing the Item[Int32] property without using its name. Вместо этого переменная, содержащая List<T> , используется как массив.Instead, the variable containing the List<T> is used as if it were an array.

C# Язык использует this ключевое слово для определения индексаторов Item[Int32] вместо реализации свойства.The C# language uses the this keyword to define the indexers instead of implementing the Item[Int32] property. В языке Visual Basic в качестве свойства по умолчанию реализовано свойство Item[Int32], предоставляющее те же возможности индексирования.Visual Basic implements Item[Int32] as a default property, which provides the same indexing functionality.

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 как допустимое значение для ссылочных типов и допускает дублирование элементов.List<T> accepts null as a valid value for reference types and allows duplicate elements.

Это свойство предоставляет доступ к указанному элементу коллекции при использовании следующего синтаксиса: myCollection[index].This property provides the ability to access a specific element in the collection by using the following syntax: myCollection[index].

Получение значения этого свойства является операцией O (1); Задание свойства также является операцией O (1).Retrieving the value of this property is an O(1) operation; setting the property is also an O(1) operation.

Применяется к

Дополнительно