StringCollection.IList.Insert(Int32, Object) StringCollection.IList.Insert(Int32, Object) StringCollection.IList.Insert(Int32, Object) Method

Определение

Вставляет элемент в коллекцию StringCollection по указанному индексу.Inserts an element into the StringCollection at the specified index.

 virtual void System.Collections.IList.Insert(int index, System::Object ^ value) = System::Collections::IList::Insert;
void IList.Insert (int index, object value);
Sub Insert (index As Integer, value As Object) Implements IList.Insert

Параметры

index
Int32 Int32 Int32

Отсчитываемый от нуля индекс, по которому следует вставить элемент value.The zero-based index at which value should be inserted.

value
Object Object Object

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

Реализации

Исключения

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

- или --or- Значение index больше значения Count.index is greater than Count.

Объект StringCollection доступен только для чтения.The StringCollection is read-only.

- или --or- StringCollection имеет фиксированный размер.The StringCollection has a fixed size.

Комментарии

Если Count значение уже равно емкости, емкость StringCollection массива увеличивается путем автоматического перераспределения внутреннего массива, а существующие элементы копируются в новый массив перед добавлением нового элемента.If Count already equals the capacity, the capacity of the StringCollection is increased by automatically reallocating the internal array, and the existing elements are copied to the new array before the new element is added.

Если index параметр StringCollectionравен, тоvalue добавляется в конец. CountIf index is equal to Count, value is added to the end of StringCollection.

В коллекциях с непрерывным набором элементов, таких как списки, чтобы выделить место новому элементу, следующие за точкой вставки элементы перемещаются вниз.In collections of contiguous elements, such as lists, the elements that follow the insertion point move down to accommodate the new element. Если коллекция индексируется, индексы перемещенных элементов также обновляются.If the collection is indexed, the indexes of the elements that are moved are also updated. Такое поведение не реализуется в коллекциях, в которых элементы логически сгруппированы, например в хэш-таблицах.This behavior does not apply to collections where elements are conceptually grouped into buckets, such as a hash table.

Этот метод является операцией On(), где n имеет Count.This method is an O(n) operation, where n is Count.

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

Дополнительно