XamlTypeInvoker.AddToCollection(Object, Object) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Adiciona o item fornecido a uma instância do tipo que é relevante para este 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 -> unitPublic Overridable Sub AddToCollection (instance As Object, item As Object)Parâmetros
- instance
- Object
Uma instância do tipo especificado por o XamlType foi usada para construir este XamlTypeInvoker.
- item
- Object
O item a acrescentar.
Exceções
Invocei este método num XamlTypeInvoker que é baseado num desconhecido XamlType.
-ou-
Invocei este método num XamlTypeInvoker onde o tipo relevante não é uma coleção.
instance é null.
GetAddMethod(XamlType) para isto XamlTypeInvoker devolve null.
Observações
Deve chamar este método apenas num XamlType que representa uma coleção.
Notas para Herdeiros
A implementação base inclui uma chamada ao assistente ThrowIfUnknowninterno . Este auxiliar lança sempre para casos onde a XamlTypeInvoker se baseia num desconhecido XamlType, o que inclui casos em que o UnderlyingType de é XamlTypenull.
Internamente, a implementação base chama IsCollection, e lança se o resultado for false.
A implementação base não utiliza necessariamente a sua própria GetAddMethod(XamlType) implementação. Primeiro, tenta-se um lançamento de instance to IList . Se isto tiver sucesso, é feita uma chamada para Add(Object) e o método retorna. Caso contrário, a implementação base usa CLR Invoke(Object, Object[]) para invocar o método subjacente Add , como obtido a partir de uma chamada para GetAddMethod(XamlType) este XamlTypeInvoker.
Na implementação base, nenhuma exceção é elevada a este nível se item for null. Ainda é possível que o método subjacente Add levante uma exceção quando invocado. Outras exceções em tempo de execução são possíveis se ItemType não devolver um resultado válido.
