XamlTypeInvoker.AddToDictionary(Object, Object, Object) Metoda

Definicja

Przestrzeń nazw:

System.Xaml.Schema

Zestaw:

System.Xaml.dll

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 -> unit

Public 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

NotSupportedException

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.

ArgumentNullException

instance to null.

XamlSchemaException

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.