Language

XamlTypeInvoker.AddToCollection(Object, Object) メソッド

定義

名前空間:
System.Xaml.Schema
アセンブリ:
System.Xaml.dll

指定した項目を、この XamlTypeInvokerに関連する型のインスタンスに追加します。

public:
 virtual void AddToCollection(System::Object ^ instance, System::Object ^ item);
public virtual void AddToCollection(object instance, object item);
abstract member AddToCollection : obj * obj -> unit
override this.AddToCollection : obj * obj -> unit
Public Overridable Sub AddToCollection (instance As Object, item As Object)

パラメーター

instance
Object

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

item
Object

追加するアイテムです。

例外

NotSupportedException

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

-or-

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

ArgumentNullException

instance は nullです。

XamlSchemaException

GetAddMethod(XamlType) この XamlTypeInvoker では、 nullが返されます。

注釈

このメソッドは、コレクションを表す XamlType でのみ呼び出す必要があります。

注意 (継承者)

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

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

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

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

適用対象