IDictionary.Add(Object, Object) 方法

定義

命名空間:

System.Collections

組件:

System.Runtime.dll

將隨附有索引鍵和值的項目加入至 IDictionary 物件。

public:
 void Add(System::Object ^ key, System::Object ^ value);

public void Add (object key, object? value);

abstract member Add : obj * obj -> unit

Public Sub Add (key As Object, value As Object)

參數

key

Object

Object，用做要加入之項目的索引鍵。

value

Object

Object，用做要加入之項目的值。

例外狀況

ArgumentNullException

key 為 null。

ArgumentException

具有相同索引鍵的項目已經存在 IDictionary 物件中。

NotSupportedException

IDictionary 為唯讀。

-或-

IDictionary 具有固定的大小。

範例

下列程式代碼範例示範如何實作 Add 方法。 此程式代碼範例是針對 類別提供的較大範例的 IDictionary 一部分。

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);
    }

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);
}

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

備註

您也可以使用 Item[] 屬性來新增專案，方法是設定字典中不存在的索引鍵值 (，例如 myCollection["myNonexistentKey"] = myValue ，) 。 不過，如果指定的索引鍵已存在於字典中，則設定 Item[] 屬性會覆寫舊的值。 相反地， Add 方法不會修改現有的專案。

實作可能會因是否允許索引鍵為 null而有所不同。

另請參閱

• Item[Object]