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

Определение

Вставляет элемент в коллекцию StringCollection по указанному индексу.

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

Параметры

index
Int32

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

value
Object

Вставляемый объект Object. Допускается значение null.

Реализации

Исключения

Значение параметра index меньше нуля.

-или-

Значение index больше значения Count.

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

-или-

StringCollection имеет фиксированный размер.

Комментарии

Если Count емкость уже равна, емкость увеличивается путем автоматического StringCollection перераспределения внутреннего массива, а существующие элементы копируются в новый массив перед добавлением нового элемента.

Если index значение равно Count, value добавляется в конец StringCollection.

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

Этот метод является операцией O(n), где n имеет значение Count.

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

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