XamlTypeInvoker.AddToCollection(Object, Object) Método

Definição

Namespace:

System.Xaml.Schema

Assembly:

System.Xaml.dll

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

NotSupportedException

Esse método foi invocado em um XamlTypeInvoker que se baseia em um XamlType desconhecido.

- ou -

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

ArgumentNullException

instance é null.

XamlSchemaException

GetAddMethod(XamlType) para este XamlTypeInvoker retorna null.

Comentários

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

Notas aos Herdeiros

A implementação base inclui uma chamada para o auxiliar interno ThrowIfUnknown. Esse auxiliar sempre gera para casos em que um XamlTypeInvoker é baseado em um desconhecido XamlType, o que inclui casos em que o UnderlyingType XamlType de é null.

Internamente, a implementação base chama IsCollectione gera 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 usa 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.