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

已在基于未知 XamlType 的 XamlTypeInvoker 上调用了此方法。

或

已在其相关类型不是字典的 XamlTypeInvoker 上调用了此方法。

ArgumentNullException

instance 为 null。

XamlSchemaException

此 XamlTypeInvoker 的 GetAddMethod(XamlType) 返回 null。

注解

只应在表示字典的 上 XamlType 调用此方法。

继承者说明

基本实现包括对内部帮助程序 的 ThrowIfUnknown调用。 对于基于未知 的情况XamlTypeInvoker，此帮助程序始终引发 ，其中包括 的 XamlType 为 null的情况UnderlyingType。XamlType

在内部，基实现调用 IsDictionary，如果结果为 false，则会引发 。

基本实现不一定使用其自己的 GetAddMethod(XamlType) 实现。 首先，尝试强制转换为 instanceIDictionary 。 如果此操作成功，则调用 Add(Object, Object) 并返回 方法。 否则，基实现使用 CLR Invoke(Object, Object[]) 调用基础Add方法，从对此 XamlTypeInvoker的调用GetAddMethod(XamlType)中获得。

在基本实现中，如果 item 或 key 为 null，则此级别不会引发异常。 调用时，基础 Add 方法仍可能引发异常。 如果未 ItemType 返回有效结果，则可能出现其他运行时异常。