XamlTypeInvoker.AddToCollection(Object, Object) Metodo

Definizione

Spazio dei nomi:

System.Xaml.Schema

Assembly:

System.Xaml.dll

Aggiunge l'elemento fornito a un'istanza del tipo relativa all'oggetto 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)

Parametri

instance

Object

Istanza del tipo specificato da XamlType per la costruzione di XamlTypeInvoker.

item

Object

Elemento da aggiungere.

Eccezioni

NotSupportedException

Questo metodo viene richiamato su un oggetto XamlTypeInvoker basato su un oggetto XamlType sconosciuto.

-oppure-

Questo metodo viene richiamato su un oggetto XamlTypeInvoker in cui il tipo rilevante non è una raccolta.

ArgumentNullException

instance è null.

XamlSchemaException

GetAddMethod(XamlType) per questo oggetto XamlTypeInvoker restituisce null.

Commenti

È consigliabile chiamare questo metodo solo in un oggetto XamlType che rappresenta una raccolta.

Note per gli eredi

L'implementazione di base include una chiamata al helper interno ThrowIfUnknown. Questo helper genera sempre per i casi in cui un XamlTypeInvoker è basato su un oggetto sconosciuto XamlType, che include casi in cui l'oggetto UnderlyingType XamlType è null.

Internamente, l'implementazione di base chiama IsCollectione genera se il risultato è false.

L'implementazione di base non usa necessariamente la propria GetAddMethod(XamlType) implementazione. Prima di tutto, viene tentato un cast di instance da eseguire IList . In caso di esito positivo, viene eseguita una chiamata a Add(Object) e il metodo restituisce. In caso contrario, l'implementazione di base usa CLR Invoke(Object, Object[]) per richiamare il metodo sottostante Add , come ottenuto da una chiamata a GetAddMethod(XamlType) per questo XamlTypeInvoker.

Nell'implementazione di base nessuna eccezione viene generata a questo livello se item è null. È comunque possibile che il metodo sottostante Add generi un'eccezione quando viene richiamata. Altre eccezioni di runtime sono possibili se ItemType non restituiscono un risultato valido.