IDictionary.Add(Object, Object) Yöntem

Başvuru

Tanım

Ad Alanı:: System.Collections

Bütünleştirilmiş Kod:: System.Runtime.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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

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

public void Add (object key, object value);

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

abstract member Add : obj * obj -> unit

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

Parametreler

key: Object

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

value: Object

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

Özel durumlar

ArgumentNullException

key, null değeridir.

ArgumentException

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

NotSupportedException

IDictionary salt okunurdur.

-veya-

sabit IDictionary bir boyuta sahiptir.

Örnekler

Aşağıdaki kod örneği, yönteminin Add nasıl uygulanduğunu gösterir. 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 (örneğin, myCollection["myNonexistentKey"] = myValue) yeni öğeler eklemek için de kullanabilirsiniz. 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.

Uygulamalar, anahtarın olmasına nullizin verip vermediklerine göre değişiklik gösterebilir.

Şunlara uygulanır

Ürün	Sürümler
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Ayrıca bkz.

Item[Object]

Aracılığıyla paylaş