IList<T>.Insert(Int32, T) Метод

Определение

Вставляет элемент в список IList<T> по указанному индексу.Inserts an item to the IList<T> at the specified index.

public:
 void Insert(int index, T item);
public void Insert (int index, T item);
abstract member Insert : int * 'T -> unit
Public Sub Insert (index As Integer, item As T)

Параметры

index
Int32

Отсчитываемый от нуля индекс, по которому следует вставить элемент item.The zero-based index at which item should be inserted.

item
T

Объект, вставляемый в список IList<T>.The object to insert into the IList<T>.

Исключения

index не является допустимым индексом в IList<T>.index is not a valid index in the IList<T>.

Объект IList<T> доступен только для чтения.The IList<T> is read-only.

Комментарии

Если значение параметра index равно количеству элементов в списке IList<T>, элемент item добавляется в список.If index equals the number of items in the IList<T>, then item is appended to the list.

В коллекциях с непрерывным набором элементов, таких как списки, чтобы выделить место новому элементу, следующие за точкой вставки элементы перемещаются вниз.In collections of contiguous elements, such as lists, the elements that follow the insertion point move down to accommodate the new element. Если коллекция индексируется, индексы перемещенных элементов также обновляются.If the collection is indexed, the indexes of the elements that are moved are also updated. Такое поведение не реализуется в коллекциях, в которых элементы логически сгруппированы, например в хэш-таблицах.This behavior does not apply to collections where elements are conceptually grouped into buckets, such as a hash table.

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

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