XamlTypeInvoker.AddToCollection(Object, Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.
GetAddMethod(XamlType) para isso XamlTypeInvoker retorna 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.