次の方法で共有


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);

パラメータ

  • index
    value を挿入する位置の、0 から始まるインデックス番号。
  • value
    IList に挿入する Object

例外

例外の種類 条件
ArgumentOutOfRangeException indexIList の有効なインデックスではありません。
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

参照

IList インターフェイス | IList メンバ | System.Collections 名前空間