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 Elementwert zu einer Instanz des Typs hinzu, der für diesen XamlTypeInvokerWert 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 durch die XamlType zum Erstellen dieses XamlTypeInvokerTyps angegebene wird.
- key
- Object
Wörterbuchschlüssel für das hinzuzufügende Element.
- item
- Object
Der hinzuzufügende Elementwert.
Ausnahmen
Diese Methode wurde für eine XamlTypeInvoker Methode aufgerufen, die auf einem unbekannten XamlTypebasiert.
-oder-
Diese Methode wurde für einen XamlTypeInvoker Ort aufgerufen, bei dem der relevante Typ kein Wörterbuch ist.
instance ist null.
GetAddMethod(XamlType) für diesen XamlTypeInvoker Wert wird zurückgegeben null.
Hinweise
Sie sollten diese Methode nur für ein XamlType Wörterbuch aufrufen, das ein Wörterbuch darstellt.
Hinweise für Vererber
Die Basisimplementierung enthält einen Aufruf des internen Hilfsers ThrowIfUnknown. Dieser Helfer löst immer für Fälle aus, in denen eine XamlTypeInvoker auf einem unbekannten XamlTypebasiert, was Fälle umfasst, in denen der UnderlyingTypeXamlType Fall ist null.
Intern wird die Basisimplementierung aufgerufen IsDictionaryund ausgelöst, wenn das Ergebnis lautet false.
Die Basisimplementierung verwendet nicht unbedingt eine eigene GetAddMethod(XamlType) Implementierung. Zuerst wird versucht, eine Umwandlung von instance zu IDictionary versuchen. Wenn dies erfolgreich ist, wird ein Aufruf 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) für diese XamlTypeInvokerMethode abgerufen wird.
In der Basisimplementierung wird keine Ausnahme auf dieser Ebene 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 Laufzeit exceptions are possible if ItemType does not return a valid result.
