XamlTypeInvoker.AddToDictionary(Object, Object, Object) Metoda

Definice

Obor názvů:

System.Xaml.Schema

Sestavení:

System.Xaml.dll

Přidá zadaný klíč a hodnotu položky do instance typu, který je relevantní pro tento 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

Instance typu určeného objektem použitým pro vytvoření tohoto XamlTypeInvokerobjektu XamlType .

key

Object

Klíč slovníku pro položku, kterou chcete přidat.

item

Object

Hodnota položky, která se má přidat.

Výjimky

NotSupportedException

Vyvolal tuto metodu na objektu XamlTypeInvoker , který je založen na neznámém XamlTypeobjektu .

-Nebo-

Tato metoda byla vyvolána XamlTypeInvoker na místě, kde relevantní typ není slovník.

ArgumentNullException

instance je null.

XamlSchemaException

GetAddMethod(XamlType) pro to XamlTypeInvoker vrátí nullhodnotu .

Poznámky

Tuto metodu byste měli volat pouze na objektu XamlType , který představuje slovník.

Poznámky pro dědice

Základní implementace zahrnuje volání interního pomocníka ThrowIfUnknown. Tato pomocná rutina vždy vyhodí pro případy, kdy XamlTypeInvoker je hodnota založená na neznámém XamlTypeobjektu XamlType , což zahrnuje případy, kdy UnderlyingType hodnota je null.

Interně volá základní implementace IsDictionary, a vyvolá, pokud je falsevýsledek .

Základní implementace nemusí nutně používat vlastní GetAddMethod(XamlType) implementaci. Nejprve se pokusíte přetypovat instance do IDictionary . Pokud se to podaří, provede se Add(Object, Object) volání a metoda vrátí. V opačném případě základní implementace používá CLR Invoke(Object, Object[]) k vyvolání základní Add metody, jak je získáno z volání GetAddMethod(XamlType) pro tuto XamlTypeInvoker.

V základní implementaci není na této úrovni vyvolána žádná výjimka, pokud item nebo key je null. Je stále možné, že základní Add metoda vyvolá výjimku při vyvolání. Jiné výjimky za běhu jsou možné, pokud ItemType nevrátí platný výsledek.