XamlTypeInvoker.AddToDictionary(Object, Object, Object) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> unitPublic 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
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.
instance ist null.
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.
