XamlTypeInvoker.AddToCollection(Object, Object) Método

Definição

Adiciona o item fornecido a uma instância do tipo que é relevante para isso 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

Uma instância do tipo especificado pelo XamlType usado para construir este XamlTypeInvoker.

item
Object

O item a ser adicionado.

Exceções

Invocou esse método em um XamlTypeInvoker que se baseia em um desconhecido XamlType.

- ou -

Invocou esse método em um XamlTypeInvoker local em que o tipo relevante não é uma coleção.

instance é null.

Comentários

Você só deve chamar esse método em um XamlType que represente uma coleção.

Notas aos Herdeiros

A implementação base inclui uma chamada para o auxiliar ThrowIfUnknowninterno. Esse auxiliar sempre é gerado para casos em que um XamlTypeInvoker é baseado em um desconhecido XamlType, que inclui casos em que o UnderlyingTypeXamlType é null.

Internamente, a implementação base chama IsCollectione lança se o resultado for false.

A implementação base não usa necessariamente sua própria GetAddMethod(XamlType) implementação. Primeiro, uma conversão de instance para IList é tentada. Se isso for bem-sucedido, uma chamada será Add(Object) feita e o método retornará. Caso contrário, a implementação base usará CLR Invoke(Object, Object[]) para invocar o método subjacente Add , conforme obtido de uma chamada para GetAddMethod(XamlType) isso XamlTypeInvoker.

Na implementação base, nenhuma exceção será gerada nesse nível se item for null. Ainda é possível que o método subjacente Add gere uma exceção quando invocado. Outras exceções de tempo de execução serão possíveis se ItemType não retornarem um resultado válido.

Aplica-se a