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.

-или-

Вызывает этот метод в объекте 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 не возвращает допустимый результат.