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.
