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

定義

StringCollection 内の指定したインデックスの位置に要素を挿入します。

C#
void IList.Insert (int index, object value);
C#
void IList.Insert (int index, object? value);

パラメーター

index
Int32

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

value
Object

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

実装

例外

index が 0 未満です。

または

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

StringCollection は読み取り専用です。

- または -

StringCollection は固定サイズです。

注釈

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

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

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

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

適用対象

製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0

こちらもご覧ください