クラスによって実装された場合は、指定したキーと値を持つ要素を IDictionary に追加します。
Sub Add( _
ByVal key As Object, _ ByVal value As Object _)
[C#]
void Add(
objectkey,objectvalue);
[C++]
void Add(
Object* key,Object* value);
[JScript]
function Add(
key : Object,value : Object);
パラメータ
例外
例外の種類 | 条件 |
---|---|
ArgumentNullException | key が null 参照 (Visual Basic では Nothing) です。 |
ArgumentException | 同じキーを持つ要素が、 IDictionary に既に存在します。 |
NotSupportedException | IDictionary が読み取り専用です。
または IDictionary が固定サイズです。 |
解説
Item プロパティを使用すると、ディクショナリに存在しないキーに対応する値を設定することで、新しい要素を追加することもできます。たとえば、 myCollection["myNonexistentKey"] = myValue
のように使用します。ただし、指定したキーがディクショナリに既に存在する場合、 Item プロパティを設定すると、既存の値が上書きされます。対照的に、 Add メソッドは既存の要素を変更しません。
必要条件
プラットフォーム: 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
参照
IDictionary インターフェイス | IDictionary メンバ | System.Collections 名前空間 | Item