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 を挿入する位置の、0 から始まるインデックス。

value

Object

挿入する Object。 値として null を指定できます。

実装

Insert(Int32, Object)

例外

ArgumentOutOfRangeException

index が 0 未満です。

または

index が Count より大きくなっています。

NotSupportedException

StringCollection は読み取り専用です。

- または -

StringCollection は固定サイズです。

注釈

既に容量と等しい場合 Count 、 の StringCollection 容量は内部配列を自動的に再割り当てすることで増加し、新しい要素が追加される前に既存の要素が新しい配列にコピーされます。

が とCountvalue等しい場合indexは、 のStringCollection末尾に が追加されます。

リストなどの連続する要素のコレクションでは、新しい要素を挿入するために、挿入位置より後にある要素の位置が繰り下げられます。 コレクションにインデックスがある場合、移動した要素のインデックスも更新されます。 この動作は、要素が概念的にバケットにグループ化されているハッシュ テーブルなどのコレクションには適用されません。

このメソッドは O(n) 操作です。nは Count です。

こちらもご覧ください

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