XamlTypeInvoker.AddToCollection(Object, Object) Método

Definición

Espacio de nombres:

System.Xaml.Schema

Ensamblado:

System.Xaml.dll

Agrega el elemento proporcionado a una instancia del tipo pertinente a esta 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)

Parámetros

instance

Object

Una instancia del tipo especificado por XamlType que se utiliza para construir este XamlTypeInvoker.

item

Object

Elemento que se va a agregar.

Excepciones

NotSupportedException

Se invoca este método en una clase XamlTypeInvoker que se basa en una clase XamlType desconocida.

o

Se invoca este método en una clase XamlTypeInvoker donde el tipo pertinente no es una colección.

ArgumentNullException

instance es null.

XamlSchemaException

GetAddMethod(XamlType) para XamlTypeInvoker devuelve null.

Comentarios

Solo debe llamar a este método en un XamlType objeto que representa una colección.

Notas a los desarrolladores de herederos

La implementación base incluye una llamada al asistente interno ThrowIfUnknown. Este asistente siempre produce para los casos en XamlTypeInvoker los que se 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 IsCollectiony 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 IList . Si esto se realiza correctamente, se realiza una llamada a Add(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 produce ninguna excepción en este nivel si item 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.