IDictionary.Add(Object, Object) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Dodaje element z podanym kluczem i wartością IDictionary do obiektu.
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 -> unitPublic Sub Add (key As Object, value As Object)Parametry
Wyjątki
Parametr key ma wartość null.
Element o tym samym kluczu IDictionary już istnieje w obiekcie.
Przykłady
W poniższym przykładzie kodu pokazano, jak zaimplementować metodę Add . Ten przykład kodu jest częścią większego przykładu udostępnionego dla klasy IDictionary.
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
Uwagi
Możesz również użyć Item[] właściwości , aby dodać nowe elementy, ustawiając wartość klucza, który nie istnieje w słowniku (na przykład myCollection["myNonexistentKey"] = myValue). Jeśli jednak określony klucz już istnieje w słowniku, ustawienie Item[] właściwości zastępuje starą wartość.
Add Natomiast metoda nie modyfikuje istniejących elementów.
Implementacje mogą się różnić w zależności od tego, czy zezwalają na klucz null.
