Поделиться через


Collection.IList.Insert(Int32, Object) Метод

Определение

Вставляет элемент в объект Collection по указанному индексу.

 virtual void IListInsert(int index, System::Object ^ value) = System::Collections::IList::Insert;
void IList.Insert (int index, object value);
abstract member IListInsert : int * obj -> unit
override this.IListInsert : int * obj -> unit
Sub IListInsert (index As Integer, value As Object) Implements IList.Insert

Параметры

index
Int32

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

value
Object

Объект Object для вставки в объект Collection.

Исключения

Значение параметра index не является допустимым индексом для объекта Collection.

Объект Collection доступен только для чтения.

-или-

Объект Collection имеет фиксированный размер.

Параметр value является пустой ссылкой в объекте Collection.

Комментарии

Если index равно количеству элементов в объекте Collection , то value добавляется в конец .

В коллекциях с непрерывным набором элементов, таких как списки, чтобы выделить место новому элементу, следующие за точкой вставки элементы перемещаются вниз. Если коллекция индексируется, индексы перемещенных элементов также обновляются. Такое поведение не реализуется в коллекциях, в которых элементы логически сгруппированы, например в хэш-таблицах.

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

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