PropertyCollection.IDictionary.Add(Object, Object) Yöntem

Tanım

Ad Alanı:

System.DirectoryServices

Bütünleştirilmiş Kod:

System.DirectoryServices.dll

Paket:

System.DirectoryServices v8.0.0

Kaynak:

PropertyCollection.cs

Sağlanan anahtar ve değere sahip bir öğeyi nesnesine IDictionary ekler.

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

void IDictionary.Add (object key, object value);

abstract member System.Collections.IDictionary.Add : obj * obj -> unit
override this.System.Collections.IDictionary.Add : obj * obj -> unit

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

Parametreler

key

Object

Object eklenecek öğenin anahtarı olarak kullanılacak öğesi.

value

Object

Object eklenecek öğenin değeri olarak kullanılacak öğesi.

Uygulamalar

Add(Object, Object)

Özel durumlar

ArgumentNullException

key, null değeridir.

ArgumentException

Nesnede IDictionary aynı anahtara sahip bir öğe zaten var.

NotSupportedException

IDictionary salt okunurdur.

-veya-

sabit IDictionary bir boyuta sahiptir.

Örnekler

Aşağıdaki örnekte yönteminin nasıl uygulandığı gösterilmektedir Add . Bu kod örneği, sınıfı için IDictionary sağlanan daha büyük bir örneğin parçasıdır.

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

Açıklamalar

Özelliğini, sözlükte Item[] bulunmayan bir anahtarın değerini ayarlayarak yeni öğeler eklemek için de kullanabilirsiniz (örneğin, myCollection["myNonexistentKey"] = myValue). Ancak, belirtilen anahtar sözlükte zaten varsa, özelliğini ayarlamak Item[] eski değerin üzerine yazar. Buna karşılık, Add yöntemi mevcut öğeleri değiştirmez.

Ayrıca bkz.

• Item[Object]