XamlTypeInvoker.AddToCollection(Object, Object) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將所提供的項目加入與此 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
要新增的項目。
例外狀況
instance 是 null。
GetAddMethod(XamlType) 對於此, XamlTypeInvoker 返回 null。
備註
你應該只在代表集合的 上 XamlType 呼叫這個方法。
給繼承者的注意事項
基礎實作包含對內部助手 ThrowIfUnknown的呼叫。 此輔助器總是對 a XamlTypeInvoker 基於未知 XamlType的情形 ,包括 UnderlyingType 的 XamlTypenull為 的情況。
在內部,基礎實作呼叫 IsCollection,若結果為 false則拋出 。
基礎實作不一定使用自己的 GetAddMethod(XamlType) 實作。 首先,嘗試鑄造 instance to IList 。 若成功,則呼叫 並 Add(Object) 返回該方法。 否則,基礎實作會使用 CLR Invoke(Object, Object[]) 來呼叫底層Add方法,這是從呼叫 得到GetAddMethod(XamlType)XamlTypeInvoker的。
在基礎實作中,若 item 為 , null則在此層級不會提出例外。 仍然有可能在呼叫時,底層 Add 方法會產生例外。 若 ItemType 未回傳有效結果,則可能有其他執行時例外。