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

Определение

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

Microsoft.VisualBasic

Сборка:

Microsoft.VisualBasic.dll

Вставляет элемент в объект 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.

Исключения

ArgumentOutOfRangeException

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

NotSupportedException

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

-или-

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

NullReferenceException

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

Комментарии

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

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

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

• Collection
• IList
• Insert(Int32, Object)