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

定義

名前空間:
System.Collections.Specialized
アセンブリ:
System.dll, System.Collections.Specialized.dll
アセンブリ:
netstandard.dll, System.Collections.Specialized.dll
アセンブリ:
System.Collections.Specialized.dll
アセンブリ:
System.dll
アセンブリ:
netstandard.dll
ソース:
StringCollection.cs
ソース:
StringCollection.cs
ソース:
StringCollection.cs
ソース:
StringCollection.cs
ソース:
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);
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の容量が増え、新しい要素が追加される前に既存の要素が新しい配列にコピーされます。

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

リストなどの連続する要素のコレクションでは、挿入ポイントに続く要素は、新しい要素に合わせて下に移動します。 コレクションにインデックスが付いている場合、移動される要素のインデックスも更新されます。 この動作は、要素が概念的にバケット (ハッシュ テーブルなど) にグループ化されるコレクションには適用されません。

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

適用対象

こちらもご覧ください