IOrderedDictionary.Insert メソッド

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

IOrderedDictionary.Insert メソッド

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

コレクション内の指定したインデックス位置に、キーと値のペアを挿入します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As IOrderedDictionary
Dim index As Integer
Dim key As Object
Dim value As Object

instance.Insert(index, key, value)

C#

void Insert (
    int index,
    Object key,
    Object value
)

C++

void Insert (
    int index, 
    Object^ key, 
    Object^ value
)

J#

void Insert (
    int index, 
    Object key, 
    Object value
)

JScript

function Insert (
    index : int, 
    key : Object, 
    value : Object
)

パラメータ

index

キーと値のペアを挿入する位置の、0 から始まるインデックス。

key

追加する要素のキーとして使用するオブジェクト。

value

追加する要素の値として使用するオブジェクト。値は null 参照 (Visual Basic では Nothing) に設定できます。

例外

例外の種類	条件
ArgumentOutOfRangeException	index が 0 未満です。 または index が Count より大きい値です。
ArgumentNullException	key が null 参照 (Visual Basic では Nothing) です。
ArgumentException	同じキーを持つ要素が、IOrderedDictionary コレクションに既に存在します。
NotSupportedException	IOrderedDictionary コレクションが読み取り専用です。 または IOrderedDictionary コレクションが固定サイズです。

解説

IOrderedDictionary は、null 参照 (Visual Basic では Nothing) を有効な値として受け取り、要素の重複を許可します。

index パラメータと Count が等しい場合は、value パラメータが IOrderedDictionary コレクションの末尾に追加されます。

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

使用例

ArrayList クラスに基づいた単純な IOrderedDictionary の実装を次のコード例に示します。実装される IOrderedDictionary は名をキーとして格納し、姓を値として格納します。それぞれの名は一意である必要があります。このコードは、IOrderedDictionary クラスのトピックで取り上げているコード例の一部分です。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

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