XamlTypeInvoker.AddToCollection(Object, Object) Méthode

Définition

Espace de noms:

System.Xaml.Schema

Assembly:

System.Xaml.dll

Ajoute l’élément fourni à une instance du type adapté à ce XamlTypeInvoker.

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)

Paramètres

instance

Object

Instance du type spécifié par le XamlType utilisé pour construire ce XamlTypeInvoker.

item

Object

Élément à ajouter.

Exceptions

NotSupportedException

A appelé cette méthode sur un XamlTypeInvoker basé sur un XamlType inconnu.

-ou-

A appelé cette méthode sur un XamlTypeInvoker où le type pertinent n’est pas une collection.

ArgumentNullException

instance a la valeur null.

XamlSchemaException

GetAddMethod(XamlType) pour ce XamlTypeInvoker retourne null.

Remarques

Vous ne devez appeler cette méthode que sur une XamlType collection.

Notes pour les héritiers

L’implémentation de base inclut un appel à l’assistance interne ThrowIfUnknown. Cet assistance lève toujours pour les cas où un XamlTypeInvoker est basé sur un inconnuXamlType, ce qui inclut les cas où l’est XamlType UnderlyingType null.

En interne, l’implémentation de base appelle IsCollectionet lève si le résultat est false.

L’implémentation de base n’utilise pas nécessairement sa propre GetAddMethod(XamlType) implémentation. Tout d’abord, un cast de instance to IList est tenté. Si cela réussit, un appel est Add(Object) effectué et la méthode retourne. Sinon, l’implémentation de base utilise CLR Invoke(Object, Object[]) pour appeler la méthode sous-jacente Add , comme obtenu à partir d’un appel pour GetAddMethod(XamlType) ce XamlTypeInvoker.

Dans l’implémentation de base, aucune exception n’est levée à ce niveau si item c’est le cas null. Il est toujours possible que la méthode sous-jacente Add déclenche une exception lorsqu’elle est appelée. D’autres exceptions d’exécution sont possibles si ItemType elles ne retournent pas de résultat valide.