XamlTypeInvoker.AddToDictionary(Object, Object, Object) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Agrega el valor de clave y elemento proporcionados a una instancia del tipo que es relevante para este 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)
Parámetros
- instance
- Object
Instancia del tipo especificado por el XamlType utilizado para construir este XamlTypeInvokerobjeto .
- key
- Object
Clave de diccionario para el elemento que se va a agregar.
- item
- Object
Valor del elemento que se va a agregar.
Excepciones
Se invocó este método en un XamlTypeInvoker que se basa en un objeto desconocido XamlType.
o
Se invocó este método en un donde XamlTypeInvoker el tipo pertinente no es un diccionario.
instance es null.
GetAddMethod(XamlType) para esto devuelve XamlTypeInvokernull.
Comentarios
Solo debe llamar a este método en un XamlType que representa un diccionario.
Notas a los desarrolladores de herederos
La implementación base incluye una llamada al asistente ThrowIfUnknowninterno. Este asistente siempre produce casos en los que se XamlTypeInvoker basa en un objeto desconocido XamlType, que incluye los casos en los que el UnderlyingType de XamlType es null.
Internamente, la implementación base llama a IsDictionaryy produce si el resultado es false.
La implementación base no usa necesariamente su propia GetAddMethod(XamlType) implementación. En primer lugar, se intenta realizar una conversión de instance a IDictionary . Si esto se realiza correctamente, se realiza una llamada a Add(Object, Object) y el método devuelve. De lo contrario, la implementación base usa CLR Invoke(Object, Object[]) para invocar el método subyacente Add , como se obtiene de una llamada a GetAddMethod(XamlType) para este XamlTypeInvoker.
En la implementación base no se genera ninguna excepción en este nivel si item o key es null. Todavía es posible que el método subyacente Add genere una excepción cuando se invoque. Otras excepciones en tiempo de ejecución son posibles si ItemType no devuelve un resultado válido.