StringCollection.IList.Insert(Int32, Object) 方法

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

将元素插入 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

应插入 value 的从零开始的索引。

要插入的 Object。该值可以为 null。

Insert(Int32, Object)

index 小于零。

- 或 -

index 大于 Count。

- 或 -

StringCollection 具有固定的大小。

如果 Count 已等于容量，则通过自动重新分配内部数组来增加的容量 StringCollection ，并在添加新元素之前将现有元素复制到新数组。

如果 index 等于 Count， value 则添加到的 StringCollection末尾。

在由连续的元素组成的集合（如列表）中，插入点下面的元素将下移以容纳新的元素。如果集合具有索引，则移动的元素的索引也将更新。此行为不适用于元素按概念划分为不同存储桶的集合，如哈希表。

此方法是 O (n) 操作，其中 n 为 Count。