IList.Insert

.NET Framework クラス ライブラリ リファレンス

IList.Insert メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

IList の指定したインデックス位置に項目を挿入します。

名前空間: System.Collections.Generic
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Sub Insert ( _
    index As Integer, _
    item As T _
)

Visual Basic (使用法)

Dim instance As IList(Of
 T)
Dim index As Integer
Dim item As T

instance.Insert(index, item)

C#

void Insert (
    int index,
    T item
)

C++

void Insert (
    int index, 
    T item
)

J#

void Insert (
    int index, 
    T item
)

JScript

function Insert (
    index : int, 
    item : T
)

パラメータ

index

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

item

IList に挿入するオブジェクト。

例外

例外の種類	条件
ArgumentOutOfRangeException	index が IList の有効なインデックスではありません。
NotSupportedException	IList は読み取り専用です。

解説

index が IList 内の項目数に等しければ、item がリストに追加されます。

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
IList ジェネリック インターフェイス
IList メンバ
System.Collections.Generic 名前空間
ICollection.IsReadOnly プロパティ

IList.Insert メソッド

指定したインデックスの IList に項目を挿入します。

名前空間: System.Collections
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Sub Insert ( _
    index As Integer, _
    value As Object _
)

Visual Basic (使用法)

Dim instance As IList
Dim index As Integer
Dim value As Object

instance.Insert(index, value)

C#

void Insert (
    int index,
    Object value
)

C++

void Insert (
    int index, 
    Object^ value
)

J#

void Insert (
    int index, 
    Object value
)

JScript

function Insert (
    index : int, 
    value : Object
)

パラメータ

index

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

value

IList に挿入する Object。

例外

例外の種類	条件
ArgumentOutOfRangeException	index が IList の有効なインデックスではありません。
NotSupportedException	IList は読み取り専用です。 または IList が固定サイズです。
NullReferenceException	value は、IList 内の null 参照です。

解説

index が IList 内の項目数に等しければ、value が末尾に追加されます。

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
IList インターフェイス
IList メンバ
System.Collections 名前空間