StringCollection.IList.Insert(Int32, Object) メソッド

定義

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

パラメーター

index
Int32

value を挿入する位置の、0 から始まるインデックス。

value
Object

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

実装

例外

index が 0 未満です。

または

indexCount より大きくなっています。

StringCollection は読み取り専用です。

- または -

StringCollection は固定サイズです。

注釈

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

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

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

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

適用対象

こちらもご覧ください