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 擲回 ，其中包括 的 為 null 的案例 UnderlyingTypeXamlType 。 XamlType

在內部，基底實作會呼叫 IsDictionary ，如果結果為 false ，則會擲回 。

基底實作不一定使用自己的 GetAddMethod(XamlType) 實作。 首先，嘗試轉換成 instanceIDictionary 。 如果成功，就會呼叫 Add(Object, Object) ，而 方法會傳回 。 否則，基底實作會使用 CLR Invoke(Object, Object[]) 叫用基礎 Add 方法，如同從 GetAddMethod(XamlType) 呼叫取得這個 XamlTypeInvoker 的 。

在基底實作中，如果 item 或 key 為 null ，則不會在此層級引發例外狀況。 在叫用時，基礎 Add 方法仍可能會引發例外狀況。 如果未 ItemType 傳回有效的結果，則可能會有其他執行時間例外狀況。