次の方法で共有


IDictionary.Add メソッド

クラスによって実装された場合は、指定したキーと値を持つ要素を 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);

パラメータ

  • 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