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

定义

命名空间:

System.Collections.Specialized

程序集:

System.Collections.Specialized.dll

Source:

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