Partilhar via


XamlTypeInvoker.AddToDictionary(Object, Object, Object) Método

Definição

Adiciona o valor de chave e item fornecido a uma instância do tipo que é relevante para esse XamlTypeInvoker.

public:
 virtual void AddToDictionary(System::Object ^ instance, System::Object ^ key, System::Object ^ item);
public virtual void AddToDictionary (object instance, object key, object item);
abstract member AddToDictionary : obj * obj * obj -> unit
override this.AddToDictionary : obj * obj * obj -> unit
Public Overridable Sub AddToDictionary (instance As Object, key As Object, item As Object)

Parâmetros

instance
Object

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

key
Object

Chave de dicionário para o item a ser adicionado.

item
Object

O valor do item a adicionar.

Exceções

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 é um dicionário.

instance é null.

Comentários

Você só deve chamar esse método em um XamlType que representa um dicionário.

Notas aos Herdeiros

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

Internamente, a implementação base chamará IsDictionarye gerará 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 IDictionary é tentada. Se isso for bem-sucedido, uma chamada para Add(Object, Object) será 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) para este XamlTypeInvoker.

Na implementação base, nenhuma exceção será gerada nesse nível se item ou key 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 retornar um resultado válido.

Aplica-se a