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 -> unitSub IListInsert (index As Integer, value As Object) Implements IList.InsertПараметры
- index
- Int32
Отсчитываемый от нуля индекс, по которому следует вставить элемент value.
- value
- Object
Объект Object для вставки в объект Collection.
Исключения
Значение параметра index не является допустимым индексом для объекта Collection.
Параметр value является пустой ссылкой в объекте Collection.
Комментарии
Если index равно количеству элементов в объекте Collection , то value добавляется в конец .
В коллекциях с непрерывным набором элементов, таких как списки, чтобы выделить место новому элементу, следующие за точкой вставки элементы перемещаются вниз. Если коллекция индексируется, индексы перемещенных элементов также обновляются. Такое поведение не реализуется в коллекциях, в которых элементы логически сгруппированы, например в хэш-таблицах.
