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

この XamlTypeInvoker を構築するために使用した XamlType によって指定された型のインスタンス。

key
Object

追加するアイテムのディクショナリ キー。

item
Object

加算する項目値。

例外

NotSupportedException

不明な XamlType に基づく XamlTypeInvoker で、このメソッドを呼び出しました。

- または -

関連する型がディクショナリではない XamlTypeInvoker で、このメソッドを呼び出しました。

ArgumentNullException

instance が nullです。

XamlSchemaException

この XamlTypeInvoker の GetAddMethod(XamlType) は、null を返します。

注釈

このメソッドは、ディクショナリを表す に対 XamlType してのみ呼び出す必要があります。

注意 (継承者)

基本実装には、内部ヘルパー ThrowIfUnknownへの呼び出しが含まれています。 このヘルパーは、 がXamlTypeInvoker不明XamlTypeな に基づいている場合に常に をスローします。これには、 XamlType の が であるnullケースがUnderlyingType含まれます。

内部的には、基本実装は を呼び出 IsDictionaryし、結果が の場合は falseをスローします。

基本実装では、必ずしも独自 GetAddMethod(XamlType) の実装が使用されるとは限りません。 まず、 へのIDictionaryキャストinstanceが試行されます。 これが成功した場合は、 の Add(Object, Object) 呼び出しが行われ、 メソッドは を返します。 それ以外の場合、基本実装では CLR を使用Invoke(Object, Object[])して、この XamlTypeInvokerの 呼び出しから取得した基になるAddメソッドをGetAddMethod(XamlType)呼び出します。

基本実装では、 または key が の場合item、このレベルでは例外はnull発生しません。 基になる Add メソッドが呼び出されたときに例外を発生させる可能性があります。 が有効な結果を返さない場合は、他の実行時例外が発生する可能性 ItemType があります。

適用対象