XamlTypeInvoker.AddToDictionary(Object, 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 a chave e o valor do item fornecidos a uma instância do tipo que é relevante para isso 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 -> unitPublic 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 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 é um dicionário.
instance é null.
GetAddMethod(XamlType) para isso XamlTypeInvoker retorna null.
Comentários
Você só deve chamar esse método em um XamlType que represente um dicionário.
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 IsDictionarye 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 IDictionary é tentada. Se isso for bem-sucedido, uma chamada será Add(Object, 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 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 retornarem um resultado válido.
