Поделиться через


SqlDataSourceView.ExecuteInsert(IDictionary) Метод

Определение

Выполняет операцию вставки, используя SQL-строку InsertCommand, все параметры, заданные в коллекции InsertParameters, и значения, содержащиеся в заданной коллекции 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 значений, используемых вместе со свойством InsertCommand для выполнения операции вставки в базу данных. Если с запросом не связан ни один параметр или если свойство InsertCommand не является параметризованным SQL-запросом, передает значение null.

Возвращаемое значение

Значение, представляющее число строк, вставленных в основную базу данных.

Исключения

Объекту SqlDataSource не удается установить подключение к базовому источнику данных.

У текущего пользователя нет надлежащих прав для получения доступа к базе данных.

Значение свойства CanInsertfalse.

Комментарии

Класс SqlDataSourceView реализует наследуемый ExecuteInsert метод для вставки данных в базу данных. Разработчики страниц и авторы элементов управления, привязанных к данным, не вызывают ExecuteInsert метод напрямую. Вместо этого используйте открытый Insert метод.

Перед выполнением OnInserting операции вставки вызывается метод для вызова Inserting события . Это событие можно обработать для проверки значений параметров и выполнения любой предварительной обработки перед вставкой.

Чтобы выполнить операцию вставки, SqlDataSourceView объект создает DbCommand объект с использованием InsertCommand текста и всех связанных InsertParameters свойств, а затем выполняет объект для DbCommand базовой базы данных. После завершения OnInserted вставки вызывается метод для вызова Inserted события . Это событие можно обрабатывать для проверки любых возвращаемых значений и кодов ошибок, а также для выполнения любой последующей обработки.

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

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