XamlTypeInvoker.AddToDictionary(Object, Object, Object) Metodo

Definizione

Spazio dei nomi:

System.Xaml.Schema

Assembly:

System.Xaml.dll

Aggiunge la chiave e il valore dell'elemento forniti a un'istanza del tipo relativa all'oggetto 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)

Parametri

instance

Object

Istanza del tipo specificato da XamlType per la costruzione di XamlTypeInvoker.

key

Object

Chiave del dizionario per l'elemento da aggiungere.

item

Object

Valore dell'elemento da aggiungere.

Eccezioni

NotSupportedException

Questo metodo viene richiamato su un oggetto XamlTypeInvoker basato su un oggetto XamlType sconosciuto.

-oppure-

Questo metodo viene richiamato su un oggetto XamlTypeInvoker in cui il tipo rilevante non è un dizionario.

ArgumentNullException

instance è null.

XamlSchemaException

GetAddMethod(XamlType) per questo oggetto XamlTypeInvoker restituisce null.

Commenti

È consigliabile chiamare questo metodo solo su un XamlType oggetto che rappresenta un dizionario.

Note per gli eredi

L'implementazione di base include una chiamata all'helper ThrowIfUnknowninterno . Questo helper genera sempre per i casi in cui un XamlTypeInvoker è basato su un oggetto sconosciuto XamlType, che include i casi in cui l'oggetto UnderlyingTypeXamlType di è null.

Internamente, l'implementazione di base chiama IsDictionarye genera se il risultato è false.

L'implementazione di base non usa necessariamente la propria GetAddMethod(XamlType) implementazione. In primo luogo, viene eseguito un cast di instance a IDictionary . Se l'operazione ha esito positivo, viene effettuata una chiamata a Add(Object, Object) e il metodo restituisce . In caso contrario, l'implementazione di base usa CLR Invoke(Object, Object[]) per richiamare il metodo sottostante Add , come ottenuto da una chiamata a GetAddMethod(XamlType) per questo XamlTypeInvokeroggetto .

Nell'implementazione di base non viene generata alcuna eccezione a questo livello se item o key è null. È comunque possibile che il metodo sottostante Add generi un'eccezione quando viene richiamata. Altre eccezioni di runtime sono possibili se ItemType non restituisce un risultato valido.