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

Определение

Пространство имен:

System.Xaml.Schema

Сборка:

System.Xaml.dll

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

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

Исключения

NotSupportedException

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

-или-

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

ArgumentNullException

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

XamlSchemaException

Метод 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 не возвращает допустимый результат.