XamlTypeInvoker.AddToDictionary(Object, 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 a chave e o valor do item fornecidos a uma instância do tipo que é relevante para este 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 por o XamlType foi usada para construir este XamlTypeInvoker.
- key
- Object
Chave do dicionário para o item a adicionar.
- item
- Object
O valor do 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 é um dicionário.
instance é null.
GetAddMethod(XamlType) para isto XamlTypeInvoker devolve null.
Observações
Deves chamar este método apenas a um XamlType que representa um dicionário.
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 IsDictionary, 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 IDictionary . Se isto tiver sucesso, é feita uma chamada para Add(Object, 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 ou key 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.
