Поделиться через


XamlTypeInvoker.AddToDictionary(Object, Object, Object) Метод

Определение

Добавляет предоставленный ключ и значение элемента в экземпляр типа, который относится к этому элементу 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)

Параметры

instance
Object

Экземпляр типа, указанного параметром XamlType, который используется для создания этого объекта XamlTypeInvoker.

key
Object

Ключ словаря для добавления элемента.

item
Object

Значение элемента для добавления.

Исключения

Вызывает этот метод в объекте XamlTypeInvoker, основанном на неизвестном типе XamlType.

-или-

Вызывает этот метод в XamlTypeInvoker (где соответствующий тип не является словарем).

instance имеет значение null.

Метод GetAddMethod(XamlType) для этого объекта XamlTypeInvoker возвращает значение null.

Комментарии

Этот метод следует вызывать только для объекта , XamlType представляющего словарь.

Примечания для тех, кто наследует этот метод

Базовая реализация включает вызов внутреннего вспомогательного средства ThrowIfUnknown. Этот вспомогательный метод всегда вызывает исключение в случаях, когда объект XamlTypeInvoker основан на неизвестном XamlType, в том числе в случаях, когда UnderlyingType для XamlType имеет значение null.

На внутреннем уровне базовая реализация вызывает IsDictionaryи выдает, если результатом является false.

Базовая реализация не обязательно использует собственную GetAddMethod(XamlType) реализацию. Сначала выполняется попытка приведения instance к IDictionary . В случае успеха выполняется вызов Add(Object, Object) и возвращается метод . В противном случае базовая реализация использует среду CLR Invoke(Object, Object[]) для вызова базового Add метода, полученного из вызова GetAddMethod(XamlType) для этого XamlTypeInvoker.

В базовой реализации на этом уровне исключение не возникает, если item или key имеет значение null. По-прежнему возможно, что базовый Add метод вызовет исключение. Другие исключения времени выполнения возможны, если ItemType не возвращает допустимый результат.

Применяется к