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 -> intProtected Overrides Function ExecuteInsert (values As IDictionary) As IntegerПараметры
- values
- IDictionary
Объект IDictionary значений, используемых вместе со свойством InsertCommand для выполнения операции вставки в базу данных. Если с запросом не связан ни один параметр или если свойство InsertCommand не является параметризованным SQL-запросом, передает значение null.
Возвращаемое значение
Значение, представляющее число строк, вставленных в основную базу данных.
Исключения
Объекту SqlDataSource не удается установить подключение к базовому источнику данных.
У текущего пользователя нет надлежащих прав для получения доступа к базе данных.
Значение свойства CanInsert — false.
Комментарии
Класс SqlDataSourceView реализует наследуемый ExecuteInsert метод для вставки данных в базу данных. Разработчики страниц и авторы элементов управления, привязанных к данным, не вызывают ExecuteInsert метод напрямую. Вместо этого используйте открытый Insert метод.
Перед выполнением OnInserting операции вставки вызывается метод для вызова Inserting события . Это событие можно обработать для проверки значений параметров и выполнения любой предварительной обработки перед вставкой.
Чтобы выполнить операцию вставки, SqlDataSourceView объект создает DbCommand объект с использованием InsertCommand текста и всех связанных InsertParameters свойств, а затем выполняет объект для DbCommand базовой базы данных. После завершения OnInserted вставки вызывается метод для вызова Inserted события . Это событие можно обрабатывать для проверки любых возвращаемых значений и кодов ошибок, а также для выполнения любой последующей обработки.
