SqlDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет операцию обновления, используя SQL-строку UpdateCommand, все параметры, имеющиеся в коллекции UpdateParameters, и значения, содержащиеся в заданных коллекциях keys, values и oldValues.
protected:
override int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);protected override int ExecuteUpdate (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> intProtected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As IntegerПараметры
- keys
- IDictionary
Объект IDictionary первичных ключей, используемых вместе со свойством UpdateCommand для выполнения операции обновления базы данных. Если с запросом не связан ни один ключ или если свойство UpdateCommand не является параметризованным SQL-запросом, передает значение null.
- values
- IDictionary
Объект IDictionary значений, используемых вместе со свойством UpdateCommand для выполнения операции обновления базы данных. Если с запросом не связан ни один параметр или если свойство UpdateCommand не является параметризованным SQL-запросом, передает значение null.
- oldValues
- IDictionary
Объект IDictionary, предоставляющий исходные значения в базе данных. Если с запросом не связан ни один параметр или если свойство UpdateCommand не является параметризованным SQL-запросом, передает значение null.
Возвращаемое значение
Значение, представляющее число строк, обновленных в основной базе данных.
Исключения
Объекту SqlDataSource не удается установить подключение к базовому источнику данных.
-или-
Свойству ConflictDetection присвоено значение CompareAllValues без передачи параметра oldValues.
У текущего пользователя нет надлежащих прав для получения доступа к базе данных.
Значение свойства CanUpdate — false.
Комментарии
Класс SqlDataSourceView реализует наследуемый ExecuteUpdate метод для обновления данных в базе данных. Разработчики страниц и авторы элементов управления, привязанных к данным, не вызывают ExecuteUpdate метод напрямую. Вместо этого используйте открытый Update метод.
Значения, содержащиеся в коллекциях keys и values , вычисляются и объединяются со значениями, содержащимися в UpdateParameters коллекции. Если свойству ConflictDetection присвоено значение CompareAllValues, значения, содержащиеся в oldValues коллекции, форматируются с OldValuesParameterFormatString и также объединяются.
Перед выполнением OnUpdating операции обновления вызывается метод для вызова Updating события . Это событие можно обработать для проверки значений параметров и выполнения любой предварительной обработки перед обновлением.
Для выполнения операции SqlDataSourceView создается DbCommand объект с использованием UpdateCommand текста и всех связанных UpdateParameters свойств, а затем выполняет объект в DbCommand базовой базе данных. После завершения OnUpdated операции вызывается метод для вызова Updated события . Это событие можно обрабатывать для проверки любых возвращаемых значений и кодов ошибок, а также для выполнения любой последующей обработки.
