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

Определение

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

System.Collections.Specialized

Сборка:

System.Collections.Specialized.dll

Исходный код:

StringCollection.cs

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

 virtual void System.Collections.IList.Insert(int index, System::Object ^ value) = System::Collections::IList::Insert;

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.

Реализации

Insert(Int32, Object)

Исключения

ArgumentOutOfRangeException

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

-или-

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

NotSupportedException

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

-или-

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

Комментарии

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

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

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

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

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

• Add(Object)
• Remove(Object)
• Count