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

Definição

Namespace:

System.Xaml.Schema

Assembly:

System.Xaml.dll

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

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

ArgumentNullException

instance é null.

XamlSchemaException

GetAddMethod(XamlType) para este XamlTypeInvoker retorna 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.