Language

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でこのメソッドを呼び出しました。

-or-

関連する型がディクショナリではない 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が有効な結果を返さない場合は、その他の実行時例外が発生する可能性があります。

適用対象