XamlTypeInvoker.AddToDictionary(Object, Object, Object) Methode

Definition

Namespace:

System.Xaml.Schema

Assembly:

System.Xaml.dll

Fügt den bereitgestellten Schlüssel und den Elementwert einer Instanz des Typs hinzu, der für diesen XamlTypeInvoker relevant ist.

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)

Parameter

instance

Object

Eine Instanz des Typs, der von dem für die Erstellung dieses XamlTypeInvoker verwendeten XamlType angegeben wird.

key

Object

Wörterbuchschlüssel für das hinzuzufügende Element.

item

Object

Der hinzuzufügende Elementwert.

Ausnahmen

NotSupportedException

Diese Methode wurde für einen XamlTypeInvoker aufgerufen, der auf einem unbekannten XamlType basiert.

-oder-

Diese Methode wurde für einen XamlTypeInvoker aufgerufen, wobei der entsprechende Typ kein Wörterbuch ist.

ArgumentNullException

instance ist null.

XamlSchemaException

GetAddMethod(XamlType) für diesen XamlTypeInvoker gibt null zurück.

Hinweise

Sie sollten diese Methode nur für ein XamlType aufrufen, das ein Wörterbuch darstellt.

Hinweise für Vererber

Die Basisimplementierung umfasst einen Aufruf des internen Hilfsprogramm.ThrowIfUnknown Dieser Hilfsprogramm löst immer für Fälle aus, in denen ein XamlTypeInvoker auf einem unbekannten XamlTypebasiert, was Fälle enthält, in denen der UnderlyingType von XamlType ist null.

Intern ruft die Basisimplementierung auf IsDictionaryund löst aus, wenn das Ergebnis ist false.

Die Basisimplementierung verwendet nicht unbedingt eine eigene GetAddMethod(XamlType) Implementierung. Zunächst wird versucht, eine Umwandlung von instance in zu IDictionary durchzuführen. Wenn dies erfolgreich ist, wird ein Aufruf von Add(Object, Object) ausgeführt, und die -Methode wird zurückgegeben. Andernfalls verwendet die Basisimplementierung CLR Invoke(Object, Object[]) , um die zugrunde liegende Add Methode aufzurufen, wie sie von einem Aufruf GetAddMethod(XamlType) von für dieses XamlTypeInvokerabgerufen wird.

In der Basisimplementierung wird auf dieser Ebene keine Ausnahme ausgelöst, wenn item oder key ist null. Es ist weiterhin möglich, dass die zugrunde liegende Add Methode beim Aufrufen eine Ausnahme auslöst. Andere Laufzeitausnahmen sind möglich, wenn ItemType kein gültiges Ergebnis zurückgegeben wird.