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

在以未知 XamlType 為根據的 XamlTypeInvoker 上，叫用這個方法。

-或-

在其中的相關類型不是集合的 XamlTypeInvoker 上，叫用這個方法。

ArgumentNullException

instance 為 null。

XamlSchemaException

這個 XamlTypeInvoker 的 GetAddMethod(XamlType) 會傳回 null。

備註

您應該只在代表集合的 上 XamlType 呼叫這個方法。

給繼承者的注意事項

基底實作包含對內部協助程式 ThrowIfUnknown 的呼叫。 這個協助程式一律會針對 以未知 為基礎的案例 XamlTypeInvoker 擲回 ，其中包含 的 為 null 的案例 UnderlyingType XamlType 。 XamlType

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

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

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