IList.Insert メソッド
クラスによって実装された場合は、 IList 内の指定した位置に項目を挿入します。
Sub Insert( _
ByVal index As Integer, _ ByVal value As Object _)
[C#]
void Insert(
intindex,objectvalue);
[C++]
void Insert(
intindex,Object* value);
[JScript]
function Insert(
index : int,value : Object);
パラメータ
例外
例外の種類 | 条件 |
---|---|
ArgumentOutOfRangeException | index が IList の有効なインデックスではありません。 |
NotSupportedException | IList が読み取り専用です。
または IList が固定サイズです。 |
解説
index が IList 内の項目数に等しければ、value が末尾に追加されます。
リストなどの連続する要素のコレクションでは、新しい要素を挿入するために、挿入位置より後にある要素の位置が繰り下げられます。インデックス付きのコレクションの場合は、移動した要素のインデックスも更新されます。この動作は、要素が概念的にバケットにグループ化された、ハッシュ テーブルなどのコレクションには適用されません。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard