PropertyCollection.System.Collections.IDictionary.Add メソッド

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

PropertyCollection.System.Collections.IDictionary.Add メソッド

指定したキーおよび値を持つ要素を IDictionary オブジェクトに追加します。

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

Visual Basic (宣言)

Private Sub System.Collections.IDictionary.Add
 ( _
    key As Object, _
    value As Object _
) Implements IDictionary.Add

Visual Basic (使用法)

Dim instance As PropertyCollection
Dim key As Object
Dim value As Object

CType(instance, IDictionary).Add(key, value)

C#

void IDictionary.Add (
    Object key,
    Object value
)

C++

private:
virtual void System.Collections.IDictionary.Add (
    Object^ key, 
    Object^ value
) sealed = IDictionary::Add

J#

J# では、明示的なインタフェースの実装は使用できますが、新規に宣言することはできません。

JScript

JScript では、明示的なインタフェースの実装は使用できますが、新規に宣言することはできません。

パラメータ

key

追加する要素のキーとして使用する Object。

value

追加する要素の値として使用する Object。

例外

例外の種類	条件
ArgumentNullException	key が null 参照 (Visual Basic では Nothing) です。
ArgumentException	同じキーを持つ要素が、IDictionary オブジェクトに既に存在します。
NotSupportedException	IDictionary は読み取り専用です。 または IDictionary が固定サイズです。

解説

Item プロパティを使用すると、ディクショナリ内に存在しないキーの値を設定することで、新しい要素を追加することもできます (例 : myCollection["myNonexistentKey"] = myValue)。ただし、指定したキーがディクショナリに既に存在する場合、Item プロパティを設定すると、既存の値が上書きされます。対照的に、Add メソッドは既存の要素を変更しません。

使用例

Add メソッドを実装する方法の例を次に示します。このコード例は、IDictionary クラスのトピックで取り上げているコード例の一部です。

Visual Basic

Public Sub Add(ByVal key
 As Object, ByVal value
 As Object) Implements IDictionary.Add

    ' Add the new key/value pair even if this key already exists in
 the dictionary.
    If ItemsInUse = items.Length Then
        Throw New InvalidOperationException("The
 dictionary cannot hold any more items.")
    End If
    items(ItemsInUse) = New DictionaryEntry(key, value)
    ItemsInUse = ItemsInUse + 1
End Sub

C#

public void Add(object key, object value) 
{
    // Add the new key/value pair even if this key already exists in
 the dictionary.
    if (ItemsInUse == items.Length)
        throw new InvalidOperationException("The dictionary
 cannot hold any more items.");
    items[ItemsInUse++] = new DictionaryEntry(key, value);
}

C++

public:
    virtual void Add(Object^ key, Object^ value)
    {
        // Add the new key/value pair even if this key already exists
        // in the dictionary.
        if (itemsInUse == items->Length)
        {
            throw gcnew InvalidOperationException
                ("The dictionary cannot hold any more items.");
        }
        items[itemsInUse++] = gcnew DictionaryEntry(key, value);
    }

プラットフォーム

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、1.1、1.0

参照

関連項目
PropertyCollection クラス
PropertyCollection メンバ
System.DirectoryServices 名前空間
Item