XamlTypeInvoker.AddToCollection(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 das bereitgestellte Element einer Instanz des Typs hinzu, der für diesen XamlTypeInvoker relevant ist.
public:
virtual void AddToCollection(System::Object ^ instance, System::Object ^ item);
public virtual void AddToCollection (object instance, object item);
abstract member AddToCollection : obj * obj -> unit
override this.AddToCollection : obj * obj -> unit
Public Overridable Sub AddToCollection (instance 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.
- item
- Object
Das Element, das hinzugefügt werden soll.
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 keine Sammlung ist.
instance
ist null
.
GetAddMethod(XamlType) für diesen XamlTypeInvoker gibt null
zurück.
Hinweise
Sie sollten diese Methode nur für eine XamlType -Methode aufrufen, die eine Auflistung darstellt.
Hinweise für Vererber
Die Basisimplementierung umfasst einen Aufruf des internen Hilfsprogramm ThrowIfUnknown
. Dieses Hilfsprogramm wird immer für Fälle ausgelöst, in denen ein XamlTypeInvoker auf einem unbekannten XamlTypebasiert, was Fälle einschließt, in denen der UnderlyingType von XamlType ist null
.
Intern ruft die Basisimplementierung auf IsCollectionund 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
von zu durchzuführen IList . Wenn dies erfolgreich ist, wird ein Aufruf von Add(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 aus einem Aufruf GetAddMethod(XamlType) von für diesen XamlTypeInvokerabgerufen wird.
In der Basisimplementierung wird keine Ausnahme auf dieser Ebene ausgelöst, wenn item
null
ist. 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.