XamlTypeInvoker.AddToDictionary(Object, Object, Object) Méthode

Définition

Espace de noms:

System.Xaml.Schema

Assembly:

System.Xaml.dll

Ajoute la valeur de clé et d’élément fournie à une instance du type adapté à ce XamlTypeInvoker.

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)

Paramètres

instance

Object

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

key

Object

Clé de dictionnaire pour l’élément à ajouter.

item

Object

La valeur d’é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 un dictionnaire.

ArgumentNullException

instance a la valeur null.

XamlSchemaException

GetAddMethod(XamlType) pour ce XamlTypeInvoker retourne null.

Remarques

Vous devez appeler cette méthode uniquement sur un XamlType qui représente un dictionnaire.

Notes pour les héritiers

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

En interne, l’implémentation de base appelle IsDictionaryet 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 est IDictionary tenté. Si cela réussit, un appel à Add(Object, Object) est effectué et la méthode retourne. Sinon, l’implémentation de base utilise le CLR Invoke(Object, Object[]) pour appeler la méthode sous-jacente Add , comme obtenu à partir d’un appel à GetAddMethod(XamlType) pour ce XamlTypeInvoker.

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