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 -> int
Protected 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.

Применяется к

См. также раздел