XamlTypeInvoker.AddToDictionary(Object, 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 podaną wartość klucza i elementu do wystąpienia typu, które jest istotne dla tego elementu XamlTypeInvoker.
public:
virtual void AddToDictionary(System::Object ^ instance, System::Object ^ key, System::Object ^ item);public virtual void AddToDictionary(object instance, object key, object item);abstract member AddToDictionary : obj * obj * obj -> unit
override this.AddToDictionary : obj * obj * obj -> unitPublic Overridable Sub AddToDictionary (instance As Object, key As Object, item As Object)Parametry
- instance
- Object
Wystąpienie typu określonego XamlType przez parametr używany do konstruowania tego obiektu XamlTypeInvoker.
- key
- Object
Klucz słownika elementu do dodania.
- item
- Object
Wartość elementu do dodania.
Wyjątki
Wywołano tę metodę na obiekcie XamlTypeInvoker , która jest oparta na nieznanym XamlTypeobiekcie .
-Lub-
Wywołano tę metodę w lokalizacji, XamlTypeInvoker w której odpowiedni typ nie jest słownikiem.
instance to null.
GetAddMethod(XamlType) dla tej XamlTypeInvoker wartości zwraca wartość null.
Uwagi
Tę metodę należy wywołać tylko w obiekcie XamlType reprezentującym słownik.
Uwagi dotyczące dziedziczenia
Implementacja podstawowa obejmuje wywołanie wewnętrznego pomocnika ThrowIfUnknown. Ten pomocnik zawsze zgłasza przypadki, w których element XamlTypeInvoker jest oparty na nieznanym XamlTypeobiekcie , który obejmuje przypadki, w których element UnderlyingType ma XamlTypenullwartość .
Wewnętrznie implementacja podstawowa wywołuje IsDictionarymetodę i zgłasza wartość , jeśli wynik to false.
Implementacja podstawowa nie musi używać własnej GetAddMethod(XamlType) implementacji. Po pierwsze, podjęto próbę rzutu instanceIDictionary na. Jeśli to powiedzie się, zostanie wykonane wywołanie metody Add(Object, Object) , a metoda zwróci wartość . W przeciwnym razie implementacja podstawowa używa środowiska CLR Invoke(Object, Object[]) do wywołania metody bazowej Add , uzyskanej z wywołania GetAddMethod(XamlType) dla tego XamlTypeInvokerelementu .
W implementacji podstawowej nie jest zgłaszany żaden wyjątek na tym poziomie, jeśli item element lub key jest null. Nadal istnieje możliwość, że metoda bazowa Add zgłosi wyjątek podczas wywoływanego wywołania. Inne wyjątki czasu wykonywania są możliwe, jeśli ItemType nie zwraca prawidłowego wyniku.
