SqlDataSourceView.ExecuteInsert(IDictionary) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет операцию вставки с помощью InsertCommand строки SQL, всех параметров, указанных в 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 установить подключение к базовому источнику данных.
Текущий пользователь не имеет правильных разрешений для получения доступа к базе данных.
Свойство CanInsert является false.
Комментарии
Класс SqlDataSourceView реализует унаследованный ExecuteInsert метод для вставки данных в базу данных. Разработчики страниц и авторы элементов управления с привязкой к данным не вызывают ExecuteInsert метод напрямую. Вместо этого используйте общедоступный Insert метод.
Перед выполнением OnInserting операции вставки вызывается метод для вызова Inserting события. Это событие можно обрабатывать для проверки значений параметров и выполнения предварительной обработки перед вставкой.
Для выполнения операции SqlDataSourceView вставки объект создает DbCommand объект с помощью InsertCommand текста и всех связанных InsertParameters свойств, а затем выполняет DbCommand объект в базовой базе данных. После завершения OnInserted вставки вызывается метод для вызова Inserted события. Это событие можно обрабатывать для проверки любых возвращаемых значений и кодов ошибок, а также для выполнения любой последующей обработки.