ObjectDataSourceView.ExecuteInsert(IDictionary) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет операцию вставки путем вызова метода бизнес-объектов, заданного свойством InsertMethod, используя заданную коллекцию values.
protected:
override int ExecuteInsert(System::Collections::IDictionary ^ values);protected override int ExecuteInsert (System.Collections.IDictionary values);override this.ExecuteInsert : System.Collections.IDictionary -> intProtected Overrides Function ExecuteInsert (values As IDictionary) As IntegerПараметры
- values
- IDictionary
Коллекция IDictionary параметров, используемый совместно со свойством InsertMethod для выполнения операции вставки. Если с методом не связан ни один параметр, возвращается значение null.
Возвращаемое значение
Число подлежащих вставке строк; если число неизвестно, значение -1. Для получения дополнительной информации см. Insert.
Исключения
Свойство CanInsert возвращает значение false.
Параметр values имеет значение null или пуст.
Комментарии
Класс ObjectDataSourceView реализует наследуемый ExecuteInsert метод для вставки данных в базовое хранилище данных с помощью бизнес-объекта. Разработчики страниц и авторы элементов управления, привязанных к данным, не вызывают ExecuteInsert метод напрямую. Вместо этого используйте открытый Insert метод.
Перед выполнением OnInserting вставки вызывается метод для вызова Inserting события . Это событие можно обработать для проверки значений параметров и выполнения любой предварительной обработки перед вызовом Insert метода .
Для выполнения операции вставки элемент управления использует отражение для вызова метода, ObjectDataSourceView определяемого свойством InsertMethod и любыми связанными параметрами в values коллекции, а затем выполняет его. После завершения OnInserted операции вызывается метод для вызова Inserted события . Это событие можно обработать для проверки любых возвращаемых значений, кодов ошибок и выполнения любой последующей обработки.
Дополнительные сведения о возврате количества вставленных строк см. в разделе Insert.
